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■ご購入製品を使用される際の注意事項 

ここでは、プログラムを行うハードウェア ( MVR - D 2200 V / MVR - D 2200 / MV 民 - D 2000 / MPL - D 200 0) 
をご使用になられるときにご注意いただきたい事項について説明しています。ハードウェアのご使 
用方法や、本注意事項の内容についてご不明な点、疑問点などございましたら、カノープス株式 
会をテクニカルサポートまでお問い合わせください。 

MV 民 Series Development Kit のサポートは、カノープスシステム開発サポート （ p . 19参照）で承つ 
ております。 

カノー プス株式会せ： 

干 651-2241 

神戸巿西区室谷卜 2-2 け申戸ハイテクパーク内） 

テクニカルサポート TEL .078-992-6830 

(祝祭日および当を指定休日を除く月〜金 10:00-12:00 13:00-17:00) 


参ご利用目的に関する注意事項 

医療機器や人命に関るシステムでは、絶巧にご利用にならないでください。製品の性質上、これ 
らのシステムへの導入は適しません。 


•製品の取り付けおよび取り外しに関する注意事項 

製品の取り付けや取り外しを行う場合、必ずパソコン本体および周辺機器の電源を切り、さらに電 
源ケーブルをコン七ントから抜いた状態で行ってください。 

パソコン本体および周辺機器の電源を入れたまま製品を取り付けたり取り外したりした場合、製品 
やパソコン本体、周辺機器および周辺機器に接続され ている 機器の一部が破壊され る 恐れがあり 
ます。ま t パソコン本体および周辺機器の電源ケーブルをコンセントうも抜かずにパソコン本体 
や周辺機器の管体(電源ユニットなど）、機器の金属部分を触った場合には感電する恐れがありま 
す。 


♦静電気に関する注意事項 

製品に静電気が流れると製品上の部品が破壊される恐れがあります。をコネクタや部品面 
( MVR - D 2200 V / MVR - D 2200 / MVR - D 2000 / MPL - D 200 0) には直接手を触れなレ、でください。 

靜電気は衣服や人体からも発生します。製品に触る前に、一旦接地された金属製のものに触れ 
てください(体内の静電気を放電することになります)。 


canopus 


2 



MV 民 Series Development Kit 


参消費電流に関する注意事項 

複数のあ張ボードをパソコンに取り付けるときは、ご購入製品を含めた全ての製品の消費電流の 
合計がパソコンの最大供給電流を越えていなレにとを必ず確認してください。全ボードの消費電流 
の合計がパソコンの最大供給電流を越えたりするなどの動作条件を満たさない環境で使用し続け 
ると、システムが正常に動作しない場合やシステムに負荷がかかり、パソコンが故障する原因となる 
恐れがあります。 

消費電流のわからない製品については、その製品の取あ説明書をご覧いただくか、メーカーに 
直接お問 V 、合わせ V 、ただいてお確かめください。 


•他を製品との併用に関する注意事項 

他社製品と併用されるとご購入製品は正常に動作しないことがあり、そのためにシステムが本来 
の目的を達成することができないこともあります。あらかじめ、製品単体の環境でご購入製品が正 
常に動作することをご確認ください。また、他社製品との併用でご購入製品が正常に動作しないの 
であれば、その他社製品とご購入製品との併用はお止めください。 


•その他の注意事項 

製品は指定された位置に指示通り取り付けてください。指示通りに取り付けられてない場合、製 
品 （ MVR - D 2200 V / MV 民 - D 2200 / MVR - D 2000 / MPL - D 200 0) の金属部とパソコンの金属部が接触し 
てショートするなどの要因で、製品やパソコン本体•周辺機器が破壊される恐れがあります。 

製品を取り扱うときは手など皮膚を傷つけないよう十分にご注意ください。ハードウェアの仕様上、 
製品のパネル、コネクタ、エッジ、裏面は金属のピンが突出していることがあります。製品を巧り付け 
たり取り外したりするときは、製品全体を軽く包み込むようにお持ちください。 

動作中の製品は熱により非常に熱くなります。長時間使用した製品に手を触れる際には、十分ご 
注意ください。 
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ご注意 

(1) 本製品の一部または全部を無断で複製することを禁止します。 

但)本製品の内をや仕様は将来予告無しに変更することがあります。 

城本製品は内容について万全を期して作成いたしましたが、万一ご不審な点や誤り、記載漏れな 
どお気付きの事がございましたら、当杜までご連絡ください。 

(4) 運用した結果については、城風こかかわらず責任を負いかねますのでご了承ください。 

(5) 本製品付属の ソフトウ卫ア、マニュアル、 その他添付物を含めたすべての関連品に関して、解析、 
リバースエンジニアリング、 デ コンパイル、 デ イスアッセン ブリを禁じます。 

做カノー プス、 Canopus およびそのロゴはカノープス株式会社の登録商標です。 

MVR - D 2200 V / MVR - D 2200 / MVR - D 2000 / MPL - D 2000および MV 民 Series Development Kit は力 

ノープス株式会杜の商標です。 

(7) MS、Windows は米国マイクロソフト.コーポレーションの登録商標です。またその他の商品《や 
それに類するものは各社の商標または登録商標です。 


表記について 

■本書では Microsoft ⑧ Windows ⑧ operating system を単に『 Windows 』、 Microsoft ⑧ 
WindowsNT ⑥ operating system を単に 『 WindowsNT 』 と表記します。 

■本書は Windows 上でプログラムを作成することができるホをが象に書かれています。 

■本書での説明と実際の運用方法とで相違点がある場合には、実際の運用ち法を優先するものと 
します。プログラム上の基本的な事項、プログラムのホ法などについては記載していません。 
■本書に記載されていない情報が記載される場合がありますので、ディスクに添付のテキスにアイ 
ルも必ずお読みください。 
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Versionl.lO t も Version 2.00 への変更,な 


• Versionl.lO から Version 2.00 へのアップデートにより、次の関数について引数の変更や構造 
体のメンバー追加など仕様が変更になりました。詳細については、 CHAPTERS および 
CHAPTER4 の各関数についての説明をご覧ください。 


関数 

変更内容 

ENC_Set_Callback 

引数の ENC_CB_TMAP が ENC_VOBU_ENT 

に変わりました。至た、新たに引叙ま2つ丢加さ 
れました。 

ENCInitialize 

引数の ENC_MEDIA が削除されました。 
ENC_MEDIA の取得/設定については、 

ENC_Get Media 関数/ ENC_Se し Media 関 

数で行なレ、ます。 

ENCCanOverlayWindow 

引数うつ追加されました。 

ENCCreateOverlayWindow 

引数が2つ追加されました。 

ENCGetVideoEncoderParameterEx 

ENC_VIDEO ENCODE PARAMETER EX 
構造体の reserved メンバーが削除され、新たに 

3つのメンバーが追加されました。 

ENCSetVideoEncoderParameterEx 

同上 

ENCJnitJMovie 

引数の ENC MODE が削除されました。 

DECCanOverlayWindow 

弓1数が 1 つ追加されました。 

DECCreateOverlayWindow 

引数が2つ追加されました。 

DECGetDecodeParameter 

DEC_DECODE PARAMETER 構造体にメン 
バーが2つ追カロされました。 

DECSetDecodeParameter 

同上 


※お試し版で追加された関数で、仕様が変更になったものについては記述しておりません。 
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Version 2.00 力>ら Version 2.10 への変更点 

Version 2.00 から Version 2.10 へのアップデートにより、仕様が変更になりました。変更内容はが下 
のとおりです。 

• 次の関数について引数の変更や構造体のメンバー追加など仕様が変更になりました。詳細に 


ついては、 CHAPTERS および CHAPTER4 のを関数についての説明をご覧ください。 


関数 

変更内容 

DEC Get Decode Parameter 

DEC_DECODE PARAMETER 構造体にメン 
バーを 1 つ追加客れました。 

DECSetDecodeParameter 

同上 


• この開発キットは、マイクロソフト株式会社の Visual C++ 4.2 用から Visual C++ 6.0 用に変更に 
なりました。 


Version 2.10 から Version 3.00 へのを吏点 


• Version 2.10 から Version 3.00 へのアップデートにより、次の関数について引数の変更や構造 
体のメンバー追加など仕様が変更になりました。詳細については、 CHAPTERS および 
CHAPTER4 の各関数についての説明をご覧ください。 


関数 

変更内容 

ENC_Get_Video_Encoder_Parameter_Ex 

ENC_VIDEO ENCODE PARAMETER EX 

構造をにメンバーが 1 つ画口されました。 

ENC Set Video Encoder Parameter Ex 

同上 


※新規追加された API については、ここでは記述しておりません。 
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2. 開発キットの内容 


MVR Series Development Kit ( な下、開発キットと記します ) は、ビデオ 映像を MPEG 2/ MPEG 1 フオーマ 
ットでキヤプチヤしたり、その逆に MPEG 2/ MPEG 1 フォーマットのファイルをビデオ信号として出力 

する MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 の機能をアプリケーションに組み込 
むためのコンポーネントです。 

この開発キットにはが下に示すように、インクルードファイルおよびサンプルプログラム(ソ-スコ-ドと実 
行ファイル)で構成されてレ、ます。 


C/C++ 用インクルードファイル 

Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Iiiclude¥Mvrapidef.h 


C/C++ 用ライブラリファイル 

Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Lib¥Mvrapi.lib 

C/C++ 用サンプルプログラム（ソースコード） 

Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Samples¥Eiicode 

...エンコード 

Program Files¥Canopus¥MVR-D2000 Development Kit¥ 

VC¥Samples¥Encode Memory ... エンコード（メモリ渡し） 

Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Samples¥ 

Com¥Encode communication Ex •..エンコード（通信） 

Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Samples¥Decode 

... デコード 

Program Files¥Canopus¥MVR-D2000 Development Kit¥ 

VC¥Samples¥Decode Memory ... デコード（メモリ渡し） 

Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Samples¥ 

Com¥Decode Communication Ex •.. デコード（通信） 

Program Files¥Canopus¥MVR-D2000 Development Kit¥ 

VC¥Samples¥Multi - •’ 複数枚制御 

Program Files¥Canopus¥MVR-D2000 Development Kit¥ 

VC¥Samples¥MvrCtrl ’..ActiveX コントロール 
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C/C++ 用サンプルプログラム（実行ファイル） 

Program Files¥Canopus¥MVR-D2000¥Eiicode.exe 
Program Files¥Canopus¥MVR-D2000¥Encode_m.exe 
Program Files¥Canopus¥MVR-D2000¥Eiicode_cEx.exe 
Program Files¥Canopus¥MVR-D2000¥Decode.exe 
Program Files¥Canopus¥MVR-D2000¥Decode_m.exe 
Program Files¥Canopus¥MVR-D2000¥Decode_cEx.exe 
Program Files¥Canopus¥MVR-D2000¥Multi.exe 
Program Files¥Canopus¥MVR-D2000¥MvrCtrLocx 


...エンコード 

... エンコード ( メモリ渡し ) 
... エンコード（通信） 

…デコード 

... デコード ( メモリ渡し） 

… デコード ( 通信） 
•••複数枚制御 

… ActiveX コントロール 
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3. 開発キットのインスト'ール 


本開発キットのインストールは、 MVR - D 2200 V ユーザーズマニュアル『2-5.ソフトウェアのイン 
ストール』を 参考に、 「コンポーネントの 選択」 ダイアログボックスから 「Development Kit 」 を 指定し、 イ 
ンストーノレを行ってください。 
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4. Visual C ++ でのアプリケーション開発 


♦開発環境 


プロジェクトで参照されるインクルードファイルおよびライブラリファイルのフォルダにな下のパス 
を追加してください。 

ポイント：本書では開発キットが組み込まれているフォルダを C : ¥Program Files¥Canopus¥MVR-D2000 
Development Kit¥ であると想定しています。お使いの環境に合わせて読み替えてください。 


インクルードファイル 

C :¥ Program Files¥Canopus¥MVR-D2000 Development Kit¥VC¥Iiiclude 

ライブラリ 


C :¥ Program Files¥Canopus¥MVR-D2 000 Development Kit¥VC¥Lib 


♦コンパイル 

次のファイルをインクルードしてください。 

Mvrapidef.h 


参リンク 

次のライブラリをリンクしてください。 

Mvrapi.lib 
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日.他の開発ツールでのアプリケーション開発 


この開発キットはマイクロソフト株式会社の Visual C++ 6.0 用です。 


他の開発ツール 盾語処理系） によるアプリケーションのコンパイル、リンクおよび実行結果に関する 
お問い合わせには十分にお応えできない場合があります。あらかじめご了承ください。 

お使いの開発 ツール信語 処理系) の 設定や付属 ユー テイリテイの使用により 、 Visual C ++ の インク 
ルードファイル やライブラリを利用するホ法については、開発 ツールのメーカーに お問い合わせく 
ださい。 
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6. サンプルプログラム 


開発キットにはこのドキュメントに記載されているファンクションの具体的な使用例として Visual 
C ++ に対応したサンプルが含まれています。作成しようとしているアプリケーションに組み込む機 
能に応じて各サンプルを参照してください。 

サンプルプログラムの内容は C : ¥Program File 淫 Canopus¥MVR-D 2000 Development 
Kit¥SAMPLES.TXT を参照してください。 

ポイント:本書では開発キットが化み込まれてレ、るフォルダを C:¥Program Files ¥ Canopus ¥ MVR - D 2000 
Development のがであると想定しています。お使いの環境に合わせて読みをえてくださ V 、。 


VC¥Samples¥Encode 
VC¥Samples¥Eiicode Memory 
VC¥Samples¥Com¥Encode 
Communication Ex 
VC¥Samples¥Decode 
VC¥Samples¥Decode Memory 
VC¥Samples¥Com¥Decode 
Communication Ex 
VC¥Samples¥Multi 
VC¥Samples¥MvrCtrl 


エンコード プログラム 
エンコード (メモリ 渡し ) プログラム 
エンコード（通信） プログラム 

デコード プログラム 
デコード (メモリ渡し)プログラム 
デコード施信）プログラム 

複数枚制御 

ActiveX コントロール 


Visual C ++ 用のサンプルは MFC を使用して記述しています。 
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7. 開発キットに含まれるソースコードの取り扱いについて 


本開発キットに含まれるサンプルプログラムはドキュメントを補うための資料となっています。サン 
プルプログラムのソースコード（な下、「ソースコー内といいます）自体を改変したり、その一部をお 
客様のアプリケーションに組み込んで利用してください。ただし、お客様のアプリケーションとそこに 
組み込まれたソースコードの一部との適合性に関してサポートの範囲を限定させていただくこともご 
ざレ、ますのでご了承ください。 

カノープス株式会社はソースコードの使用と変更に関して完全に自由な権利をお客様に許諾い 
たします。ただしこれらのコードをソースコードもしくはこれを変更したものの形態でお客様の営利 
を目的としたソフトウェア製品に含めることはご遠慮願レ、ます。 


ま t 最終的に作成されたアプリケーションの運用結果および目的への適合性につき、カノープ 
ス株式会化では一切の責任を負いかねますので予めご了承ください。 
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8. プログラム作成時の注意事項 


本開発キットに関するご質問は、インターネット E - mail または FAX でのみ承っております。お 
電話や NIFTY - Serve でのお問 V 、合わせにつ V 、ては 受付できませんのであらかじめご了承くださ 
レ、。 


インター不ツト E-mail mvrsdk 脚' canopus . co.jp 

カノープスシステム開発サポート FAX : 078-992-4203 

お問い合わせの際には発生現象と共に次の内をを必ず記載してください。 

1. 使用しているモジュールのバージョン情報 

な エクスプローラからファイルを 右 クリック する ことで 確認できます。 

2. 使用している開発環境 

•ご使用の Windows または Windows NT 環境 （Service Pack のノくージョン） 

治 "Windows NT 環境でお使いの場合は Service Pack 4な降ろ;インストールされてい 
る環境が必要です。 

☆対•応 OS 環境は、 MVR - D 2200 V / MVR - D 2200 / MVR - D 2000 / MPL - D 2000本体 
の動作環境に準拠します。 

☆Windows 3 .し Windows NT 3.5 x ではお使いいただけません。 （2003.6 現在） 
•コンパイラのメーカー、バージョン、対応言語 
•使用されているその他の開発キット 

3. 使用している実行環境 

• PC 本体メーカーおよび機種ぶ 
• CPU の種類 
•搭載メモリ容量 

•ご使用の Windows または Windows NT 環境 （Service Pack のノくージョン） 

な Windows NT 環境でお使いの場合は Service Pack 4な降ろ;インストールされてい 
る環境が必要です。 

☆対応 OS 環境は、 MVR - D 2200 V / MVR - D 2200 / MVR - D 2000 / MPL - D 2000本体 
の動作環境に準拠します。 

☆Windows 3 .し Windows NT 3.5 x ではお使いいただけません。 （1999.9 現在） 
•周辺機器メーカーおよび型番 
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CHAPTER 1 Tutorial 


1. エンコード アプリケーションの作成 


エンコード アプリケーションでは、 

カードの選択 
エンコーダの使用開始 
オ'ーノく'ーレイウインドウの生成 
ウィンドウの移動およびサイズ変更 

エンコードの開始 
エンコードの 停止 
オーノくーレイウインドウの破棄 
エンコーダの使用終了 


などの機能が必要となります。 

この項では、ビデオ映像をオーバーレイウインドウに表示してからエンコードを行うアプリケーシヨ 
ンの作成について説明します。本文中ではエラーチェックは省いてあります。 


※エンコード に関する機能は MPL - D 2000 では使用できません。 
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カードの選択 


MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 を複数枚装着している場合、どのカードが使用可能か 
を調べ、使用可能なカードの中から使用するカードを指定します。 

MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 を 1 枚だけ装着している場合や使用するカードを選ば 
ない場合は、カードを指定する必要はありません。 

UINT encjd; //エンコーダの 識別子 （グローバル 変数） 

ENC_CONFIG config; // カード情報を取得するための構造体 

int i; 

//カード攸数を取得 

memset(&config, 0, sizeof(ENC_CONFIG)); 

ENC Get Codec Conflg(enc id, &config); 


// 使用できるカードを探す 

for (i =1; i <= config.NumberCodecs; i++) 

{ 

con む g.CodecNumber = i; 
ENC_Get_Codec_Config(enc_id, &config); 
if (config.CurrentUtilization == FALSE) 

{ 

if(config.CodecCaps& ENCCAP ENCODE) 

{ 

// 使用するカードを指定する 

ENC_Set_Codec_Number(enc_id, i); 
break; 
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エンコーダの使用開始 


MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 を使用するアプリケーションは、その使用開始をドライ 
バに許可してもらう必要があります。アプリケーションの初期化時に ENCJnitialize または 
ENC_Initialize_Ex ファンクションを呼び出して MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 の使用 

を開始します。 


_ファイルへのエンコード 時の例_ 

UINT encjd; //エンコーダの 識別子 (グローバル 変数) 

ENC_MEDIA media; //エンコードの 種類 （グローバル 変数） 

ENCRETURN encreturn; 

enc return = ENC Initialize(enc m); 
if (enc_return != ENC_SUCCESS) 

{ 

// MVR-D2000 が使用できない 


エラー 処理 


media = ENC_MEDIA FILE; 

enc return = ENC Set Media(enc id, media); 

if (eiic_returii!= ENC_SUCCESS) 

{ 

// エンコードの種類を設定できない 


エラー 処理 
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メモリ転送時の例 

UINT encjd; // エンコーダの 識別子 (グローバル 変数) 

ENC_MEDIA media; //エンコードの 種類 （ダローバル 変数） 

EN CRETURN encreturn; 

ENC BSS PARAMETER bss oaram; 


bss_param.fType 
bssparam.pfnCallback 
b ss_p aram.cbBuff 
bssparam.cBuff 
bss_param.dwData 


=ENC_BSS_TYPE PS; 

=WriteProc; // コールノくック関数 

= 0x8000; //バッファ サイズ 

= 16; // ノくッファ数 

= (DWORD)INVALID HANDLE VALUE; 


media = ENC_MEDIA MEMORY; 

enc return = ENC Initialize_Ex(enc_id, media, &bss_param); 
if (enc_returii!= ENC_SUCCESS) 

{ 

// MVR-D2000 が使用できない 


エラー 処理 


// メモリ 転送用 コールバック 関数 

void CALLBACK WriteProc(LPBYTE pbBuff, DWORD cbBuff，DWORD dwData) 

{ 

DWORD cbWrit 化!!； 

HANDLE hFile = (HANDLE)dwData; 

if (hFile != INVALID HANDLE VALUE) 

{ 

WriteFile(hFile, pbBuff, cbBuff, &cbWritten, NULL); 


canopus 


23 







MV 民 Series Development Kit 


オーバーレイウインドウの生成 


アプリケーションのウィンドウ生成終了後、オーバーレイ表示が可能か調べてから、クライアント領域 

を Overlay Window として使用します。 


UINT encid; 

UINT n Width; 

UINT nHeight; 
HWND hWndApp; 
HWND hWndOverlay; 


// エンコーダの識別子（グローバル靈数） 

//オーバーレイ表示する幅(グローバル変数） 

//ホーノくーレイ表示する高さ（ダローノくル変数） 

//アプリケーションのメインウインドウハンドル（グローバル変歎) 
//オーバーレイウインドウのハンドル（ダローバル靈數） 


ENC RETURN enc return; 


enc return = ENC_Caii_Overlay_Wmdow(enc_id, NULL, nWidth, nHeight); 
if (enc_return != ENC_SUCCESS) 

{ 

H ホ、 ーノく'ーレイ表示ができない 


エラー 処理 

return; 


enc return = ENC Create Overlay Wmdow(enc id, hWndApp, &hWndOverlay, 0, 


0, nWidth, nHeight); 

if (enc_return != ENC_SUCCESS) 

{ 

// オーノくーレイウィンドウの生成に失敗した 


エラー 処理 

return; 
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ウィンドウの移動およびサイズ変更 

ユーザーの操作により、アプリケーションのウィンドウを移動させた時や、ウィンドウのサイズを変更 
した場合には、オーバレイウィンドウの新しレ、位置への移動やサイズ変更を巧なレ、ます。 

UINT encjd; // エンコーダの識別子（グローバル変数） 

case WM MOVE: 

{ 

INT xPos, yPos; 

xPos = (INT)(short) LOWORD(lParam); 
yPos = (INT)(short) HIWORD(lParam); 

ENC Move Overlay Window(enc_id, xPos, yPos); 

} 

return 0; 

case WM SIZE: 

{ 

UINT nWidth, nHeight; 

n Width = (UINT)LOWORD(lParam); 
nHeight = (UINT)HIWORD(lParam); 

ENC_Resize_Overlay_Wmdow(enc_id, nWidth, nHeight); 

} 

return 0; 
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エンコードの開始 


エンコードを開始する。 

エンコードを開始ずる前に必ず ENCJnitJMovie ファンクションを呼び出してエンコード開始待ち 
が:態にする。その後で ENC Record Movie ファンクションを呼び出してエンコードを開始します。 


UINT 

ENC_MEDIA 

HANDLE 

TCHAR 


enc id; 
media; 
hFile; 

szFile[MAX PATH]; 


// エンコーダの識別子（グローバル変数） 
//エンコードの種類(グローバル変歎） 

//ファイルハンドル 
//ファイル名 


ENC BSS PARAMETER bss param; 


if (media = ENC_MEDIA MEMORY) 

{ 

hFile = CreateFile(szFile, GENERIC_READ | GENERIC_WRITE, 
FILE SHARE READ, NULL, 

CREATE ALWAYS, 

FILE ATTRIBUTE NORMAL | 

FILE FLAG-SEQUENTIAL SCAN, 

NULL); 

ENC_Get_BSS_Parameter(enc_id, &bss_param); 
bss_param.dwData = (DWORD)hFile; 
ENC_Set_BSS_Parameter(enc_id, & bss param); 


ENCIni し Movie(enc_id); 

ENC_Record_Movie(enc_id, ENC_RECORD PS); 
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エンコードの停止 

エンコード中に停止する場合は、 ENC_Stop ファンクションを呼び出します。 
UINT encjd; //エンコーダの識別子（グローバル変数） 

ENC Stop(eiic id); 


オ'— ノス ’—レイウインドウの破棄 

オーバーレイウィンドウを破棄する。 WM DESTROY などで実行します。 
UINT encjd; //エンコーダの識別子（グローバル変数） 

ENC Destroy Overlay_Wmdow(enc id); 


エンコーダの使用終了 


MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 を使用するアプリケーションは、その使用終了をドライ 
バに通知する必要があります。アプリケーションの終了時などに ENC_Termmate ファンクションを 
呼び出して MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 を終了します。 

UINT encjd; //エンコーダの識別子（グローバル変数） 

ENC Termmate(eiic id); 
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2. デコードアプリケーションの作成 


デコードアプリケーションでは、 


カードの 選択 
デコーダの使用開始 
オーノくー レイウインドウの生成 
ウィンドウの 移動および サイズ 変更 
デコードの開始 
デコードの停止 
オーバーレイウインドウの破棄 
デコーダの使用終了 

などの機能が必要となります。 

この項では、画像データをオーバーレイウインドウに表示しながらデコードを行うアプリケーション 
の作成について説明します。本文中ではエラーチェックは省いてあります。 
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カードの選択 


MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 を複数枚装着している場合、どのカード 
が使用可能かを調べ、使用可能なカードの中から使用するカードを指定します。 

MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 を 1 枚だけ装着している場合や使用する 
カードを選ばない場合は、カードを指定する必要はありません。 

UINT decjd; //デコーダの 識別子 (グローバル 変数） 

DEC_CONFIG config; // カード情報を取得するための構造体 

int i; 

//カードネ女数を取得 

memset(&config, 0, sizeof(DEC_CONFIG)); 

DEC Get Codec Config(dec id, &con 打 g); 


// 使用できるカードを探す 

for (i =1; i <= config.NumberCodecs; i++) 

{ 

con む g.CodecNumber = i; 
DEC_Get_Codec_Config(dec_id, &config); 
if (config.CurrentUtilization == FALSE) 

{ 

if(config.CodecCaps& DECCAP DECODE) 

{ 

// 使用するカードを指定する 

DEC_Set_Codec_Number(dec_id, i); 
break; 
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デコーダの 使用開始 


MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 を使用するアプリケーションは、その使用 
開始をドライバに許可してもらう必要があります。アプリケーションの初期化時に DEC_Imtialize ま 
たは DEC_Iiiitialize_Ex ファンクションを呼び出して 

MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 の使用を開始します。 


ファイルからのデコード時の例 

UINT decjd; 

DEC MEDIA media; 


// デコーダの識別子(グローバル変数) 
//デコードの種類(グローバル変数） 


DEC RETURN dec return; 


decreturn = DEC_Initialize(dec_id); 
if (dec_return != DEC_SUCCESS) 

{ 

// MVR-D2000 が使用できない 


エラー 処理 


media = DEC_MEDIA FILE; 

dec return = DEC Set Media(dec id, media); 

if(dec_return != DEC_SUCCESS) 

// デコードの種類を設定できない 


エラー 処理 
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メモリ転送時の例 

UINT decjd; // デコーダの 識別子 (グローバル 変歎) 

DEC RETURN dec return; 

DEC BSR_PARAMETER bsr param; 


bsrparam.fType 

bsrparam.pfnCallback 

bsrparam.cbBuff 

bsrparam.cBuff 

bsrparam.dwData 


=DEC_BSR_TYPE PS; 

=ReadProc; // コールノくック関数 

= 0x8000; // バッファサイズ 

= 32; // バッファ歎 

= (DWORD)INVALID HANDLE VALUE; 


media = DEC_MEDIA MEMORY; 

dec return = DEC Initialize_Ex(dec_id ， media ， &bs し param); 
if (dec_return != DEC_SUCCESS) 

{ 

// MVR-D2000 が使用できない 


エラー 処理 


// メモリ弦送用 コール ノくック関数 

void CALLBACK ReadProc(LPBYTE pBuff，DWORD cbWrite ， 

LPDWORD pcbWritten, DWORD dwData) 

{ 

HANDLE hFile = (HANDLE)dwData; 
if (hFile != INVALID HANDLE VALUE) 

{ 

ReadFile(hFile, pBuff ， cbWrite, pcbWritten, NULL); 
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オーバーレイウインドウの生成 


アプリケーションのウィンドウ生成終了後、オーバーレイ表示が可能か調べてから、クライアント領域 

を Overlay Window として使用します。 


UINT decjd; 

UINT n Width; 

UINT nHeight; 
HWND hWndApp; 
HWND hWndOverlay; 


// デコーダの識別子(グローバル変数） 

//オーバーレイ表示する幅（グローバル変数） 

// ホー ノくーレイ表示する高さ （グロー ノくル変数） 

//アプリケーションのメインウインドウハンドル（グローバル変敷) 
//オーバーレイウインドウのハンドル（ダローバル靈数） 


DEC RETURN dec return; 


dec return = DEC_Can_Overlay_Wmdow(dec_id, NULL, nWidth, nHeight); 
if (dec_return != DEC_SUCCESS) 

{ 

H ホ、 ーノく'ーレイ表示ができない 


エラー 処理 

return; 


dec return = DEC Create Overlay Wmdow(dec id, hWndApp, &hWndOverlay, 0, 


0, nWidth, nHeight); 

if (dec_return != DEC_SUCCESS) 


// オーノく'ーレイウィンドウの生成に失敗した 


エラー 処理 

return; 
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ウィンドウの移動およびサイズ変更 

ユーザーの操作により、アプリケーションのウィンドウを移動させた時や、ウィンドウのサイズを変更 
した場合には、オーバレイウィンドウの新しレ、位置への移動やサイズ変更を巧なレ、ます。 

UINT decjd; //デコーダの 識別子 （グローバル 変数） 

case WM MOVE: 

{ 

INT xPos, yPos; 

xPos = (INT)(short) LOWORD(lParam); 
yPos = (INT)(short) HIWORD(lParam); 

DEC_Move_Overlay_Window(dec_id, xPos, yPos); 

} 

return 0; 

case WM SIZE: 

{ 

UINT nWidth, nHeight; 

n Width = (UINT)LOWORD(lParam); 
nHeight = (UINT)HIWORD(lParam); 

DEC_Resize_Overlay_Wmdow(dec_id, nWidth, nHeight); 

} 

return 0; 
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デコードの開始 


デコードを開始ずるには、 DEC_Play ファンクションを呼び出します。 


//デコーダの 識別子 (グローバル 変数) 
//デコードの 種類 (グローバル 変数） 

//ファイルハンドル 
//ファイル名 


UINT decjd; 
DEC MEDIA 


media; 

hFile; 

szFile[MAX PATH]; 


HANDLE 


TCHAR 


DEC_BSR_PARAMETER bsr param; 

if (media = DEC_MEDIA MEMORY) 

{ 

hFile = CreateFile(szFile, GENERIC_READ, 


FILE SHARE READ, NULL, 

OPEN EXISTING 

FILE ATTRIBUTE NORMAL | 

FILE FLAG_NO BUFFERING | 

FILE FLAG-SEQUENTIAL SCAN，NULL); 


DEC_Get_BSR_Parameter(dec_id, &bsr_param); 
bsr_param.dwData = (DWORD)hFile; 
DEC_Set_BSR_Parameter(dec_id, &bsr_param); 

} 

DEC_Play(dec_id); 
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デコードの停止 

デコード中に停止する場合は、 DEC_Stop ファンクションを呼び出します。 

UINT decjd; //デコーダの 識別子 （グローバル 変数） 

DEC_Stop(dec_id); 

オ'— バ ’—レイウインドウの破棄 

オーバーレイウィンドウを破棄します。 WM DESTROY などで実行します。 

UINT decjd; //デコーダの 識別子 （グローバル 変数） 

DEC Destroy Overlay_Wmdow(dec id); 

デコーダの使用終了 

MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 を使用するアプリケーションは、その使用 
終了をドライバに通知する必要があります。アプリケーションの終了時などに DEC_Termmate ファ 
ンクションを呼び出して MVR-D 2200 V/MVR-D 2200 /MVR-D 2000 /MPL-D 2000 を終了します。 

UINT decjd; //デコーダの 識別子 （グローバル 変数） 

DEC Termmate(dec id); 
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CHAPTER 2 Quick Reference 


§ 1 .Video Encoder Functions 


ENC Set Callback 

ENC Can Initialize 
ENCGetCodecCo 打 fig 

ENC Set Codec Number 

ENCInitialize 
ENC Initialize Ex 

ENCTerminate 

ENC Get Media 

ENC Set Media 

ENC Can Record 

ENC Get Status 
ENCCanOverlayWindow 

ENC Create Overlay Window 

ENC Destroy Overlay Window 

ENC Move Overlay Window 

ENC Resize Overlay Window 

ENC Show Overlay Window 

ENC Get Overlay Window 

ENC Get Overlay Rect 

ENCSetOverlayRect 

ENCStartMonitor 

ENC Stop Monitor 
ENCGetMonitorStatus 

ENC Get VideoCD Mode 

ENC Set VideoCD Mode 

ENC Get BSS Parameter 

ENC Set BSS Parameter 
ENCGetBS SParameterAV 

ENC Set BSS ParameterAV 

ENC Get Overlay Parameter 

ENC Set Overlay Parameter 

ENC Get Video Parameter 

ENC Set Video Parameter 

ENC_Get_Video_Parameter2 

ENC_Set_Video_Parameter2 
ENC Get Video Encode Parameter 

ENC S ぶ Video Encode Parameter 

ENC Get Video Encode Parameter Ex 

ENC Set Video Encode Parameter Ex 


コールバック 関数の設定 
エンコーダを 初期化できるか調べる 
カードに関する情報の取得 
使用する力 ■ ード 番号の設定 
エンコーダの 初期化 
お張 エンコーダの 初期化 
エンコーダの終了 
エンコードの種類の 取得 
エンコードの種類の 設定 
録画/録音できるか調べる 
ステータスの 取得 

オーバーレイウィンドウの使用可能か調べる 
オーノくー レイウインドウの生成 
オーバーレイ ウィンドウの破棄 
オーバーレイウィンドウの移動 
オーバーレイウインドウのサイズ変更 
才'ー バー レイウィンドウの表示変更 
オーバーレイウインドウのハンドル取得 
才'ーノく ■ ーレイウィンドウの表示領域の取得 
オーノ《ーレイウィンドウの表示領域の設定 
モニタ開が？ 

モニタ停止 

モニタ状態の取得 

Video CD モードの取得 

Video CD モードの設定 

メモリ転送用パラメータの取得 

メモリ転送用パラメータの設定 

エレメンタリストリームでのメモリ転送用パラメー 

夕を取得します。 

エレメンタリストリームでのメモリ転送用パラメー 
夕を設定します。 

オーバーレイ表示パラメータの 取得 
才' ー バーレイ表示パラメ'—夕の 設定 
ビデオ パラメータの 取得 
ビデオ パラメータの 設定 
ビデオ パラメータ 2 の 取得 
ビデオ パラメータ 2 の 設定 
ビデオ エンコーい 巧 メータの 取得 
ビデオ エンコードパラメータの 設定 
あ張ビデオ エンコードパラメータの 取得 
お 張ビデオ エンコードパラメータの 設定 


canopus 


36 


















































MV 民 Series Development Kit 


ENC Get Video Encode Parameter Ex2 

あ張ビデオエンコードパラメータ 2 の取得 

ENC 

Set Video じ打 code Parameter じ x2 

お張ビデオエンコードパラメータ2の設定 

ENC 

Get Audio Format 

オーディオ形式の取得 

ENC 

Set Audio Format 

オーディオ形式の設定 

ENC 

Get Audio Parameter 

ホーディホパラメータの取得 

ENC 

Set Audio Parameter 

ホーディホパラメータの設を 

ENC 

Get Audio Encode Parameter 

オーディオエンコードパラメータの取得 

ENC 

Set Audio Encode Parameter 

オーディオエンコードパラメータの設を 

ENC 

Init Movie 

エンコードの開始待ち状態にする 

ENC 

Record Movie 

エンコードの開始 

ENC 

Stop 

エンコードの停止 

ENC 

Get BitmapBits 

静止画 ( BMP ) をバッファで取得します。 

ENC 

Save DIB 

静止画 ( BMP ) をファイルに保存します。 

ENC 

Save JPEG 

静止画 ( JPEG ) をファイルに保存します。 

ENC 

Get Record Time 

エンコード時間の取得 

ENC 

Set Record Time 

エンコード時間の設定 

ENC 

Get Movie File 

エンコードファイルの取得 

ENC 

Set Movie File 

エンコードファイルの設定 

ENC 

Get Frame Count 

エンコードを行なったフレーム数の取得 

ENC 

Get Time 

エンコードを行なった時間の取得 

ENC 

Detect Video I 打 put Source 

入カ ソースの 自動検出 

ENC 

Set Digital Video Inpug 

ァナログ.ビデオ入力とデジタル.ビデオ入力を 
切り换えます。 

ENC Get Digital Video Inpug 

現在のビデオ入力の状態を取得します。 

ENC 

Set Video Encode File 

詳細ビデオ•エンコード•パラメータ用ファイルの 
設定 

ENC 

Get IRE Setting 

NTSC セットアップレベル（黒レベル）の設定を 
取得します。 

ENC 

Set IRE Setting 

NTSC セットアップレベル（黒レベル）を設定し 
ます。 

ENC 

Get Last Error 

エラーの取得 

※エンコードに関する機能は MPL - D 2000では使用できません。 
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§ 2. Video Decoder Functions 


DEC Set Callback 

DECCanI 打 itialize 
DEC Get Codec Co 打 fig 

DEC Set Codec Number 

DEC Initialize 
DEC Initialize Ex 

DECTerminate 

DEC_Ge し Media 

DEC Set Media 
DECCanPlayback 

DEC Get Status 

DEC Can Overlay Window 

DEC Create Overlay Window 
DEC Can VideoPo け Overlay Window 

DEC Create VideoPort Overlay Window 

DEC Destroy Overlay Window 

DEC Move Overlay Window 

DEC Resize Overlay Window 

DEC Show Overlay Window 

DEC Get Overlay Window 

DECGetOverlayRect 

DEC Set Overlay Rect 

DEC Start Monitor 

DECStopMonitor 
DEC Get Monitor Status 

DEC Get BS 民 Parameter 

DEC Set BS 民 Parameter 
DEC Get Overlay Parameter 

DEC S ぶ Overlay Parameter 

DECGetVideoParameter 

DEC Set Video Parameter 

DEC Get Audio Parameter 

DEC Set Audio Parameter 

DEC Get Decode Parameter 

DEC Set Decode Parameter 

DEC Play 
DECPlayFrom 

DECPause 
DEC Resume 

DEC Stop 

DEC Get BitmapBits 

DEC Save DIB 

ENC Save JPEG 
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コールバック 関数の設定 
デコーダを 初期化できるか調べる 
カードに 関する情報の取得 
使用する カード番号の 設定 
デコーダの 初期化 
お張 デコーダの 初期化 
デコーダの終了 
デコードの種類の取得 
デコードの種類の 設定 
再生できるか調べる 
ステータスの 取得 

オーバーレイウィンドウの使用可能か調べる 
オーバーレイウインドウの生成 
ビデオポートを利用したオーバーレイウィンドウ 
を使用できるかどうか半 U 断する。 

ビデオポートを利用したオーバーレイウィンドウ 
を生成する。 

オーバーレイウィンドウの 破棄 
オーバーレイウインドウの移動 
オーバーレイウインドウのサイズ 変更 
才'ー パ 'ーレイウィンドウの 表示変更 
オーバーレイウインドウのハンドル 取得 
オーノ《ーレイウィンドウの 表示領域の取得 
オーノ《ーレイウィンドウの 表示領域の設定 
モニタ 開ろを 
モニタ停止 
モニタ 状態の取得 
メモリ 転送用 パラメータの 取得 
メモリ 転送用 パラメータの 設定 
オーバーレイ 表示 パラメータの 取得 
オー ノくー レイ 表示 パラメータの 設定 
ビデオパラメータの 取得 
ビデオパラメータの 設定 
オーディオパラメータの 取得 
オーディオパラメータの 設定 
デコ ーい巧 メータの 取得 
デコードパラメータの 設定 
デコードの 開始 

指定位置からの デコードの 開始 
デコードの一時停止 
デコードの 再開 
デコードの停止 

静止画 ( BMP ) をバッファで取得します。 

静止画 ( BMP ) をファイルに保存します。 

静止画 ( JPEG ) をファイルに保存します。 
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DEC Get Repeat 

DEC Set Repeat 
DEC Get Movie File 

DEC Set Movie File 

DEC Get Image Size 

DEC Get Frame Count 

DECGetTime 

DECGetType 
DEC Get File Type 
DEC_Ge し Playback-Time 

DEC Seek 

DEC Get Sync Stc Value 

DEC Get IRE Setting 

DEC Set IRE Setting 

DEC Get Overlay Parameter Ex 

DEC S 过 Overlay Parameter Ex 
DEC Get Overlay Parameter 民 a 打を e Ex 

DEC Get Last Error 


リピート状態の取得 
リピート状態の設定 
デコードファイルの 取得 
デコードファイルの 設定 
画像サイズの取得 

デコードを行なったフレーム数の取得 
デコードを行なった時間取得 
デコードタイプの取得 
ファイルタイプの取得 
再生時間の取得 
再生開始位置の指定 

HD814210 の SYNC STC レジスタの値を取得 
NTSC セットアップレベル（黒レベル）の設定を 
取得します。 

NTSC セットアップレベル（黒レベル）を設定し 
ます。 

オーバーレイの 設定を取得します。 
オーバーレイの 設定を行なレ、ます。 
オーバーレイ 表示 パラメータの 範囲を取得しま 
す。 

エラーの 取得 
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コールバック関数の設定を行ないます。 


書式 


ENC_RETURN ENC_Set Callback(UINT encjd, ENC_CB STATUS pStatus, 

ENC_CB ERROR pError, 
ENC_CB VOBU_ENT pVobu_ent ， 
ENC_CB S_PTM pSptm, 

ENC CB SVOB ENT pSvob_ent); 


I 引数 I 

encid エンコーダの識別子 

pStatus 内部が態通知用コールバック関数を設定する 

pError エラー通知用コールバック関数を設定する 

pVobu_ent GOP 完結モードでの情報取得用コールバック関数を設定する 

pSptm 予約 NULL を渡す 

pSvob_ent 予約 NULL を渡す 

ENC_CB STATUS コールバック関数の定義 

エンコーダの内部 状態を取得するた めのコールバック 関数 

VOID CALLBACK StatusProc(UINT encjd, ENC_STATUS_NOTIFY status); 
encid エンコーダの識別子 

status 内部状態 


値 

説明 

ENC NOTIFY INITIALIZE 

エンコーダの初期化が行われた 

ENC NOTIFY TERMINATE 

エンコーダが終了した 

ENC NOTIFY STOP 

エンコードが停止した 

ENC NOTIFY INIT MOVIE 

エンコード開始待ち状態になった 

ENC NOTIFY MOVIE 

エンコードを關始した 


ENC_CB ERROR コールバック関数の定義 

エンコード中にエラーが発生した場合に、そのエラー情報を取得するためのコールバック関数 

VOID CALLBACK ErrorProc(UINT encjd, ULONG error); 
encid エンコーダの識別子 

error エラーコード (APPENDIX1. エラーコード表参照） 
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ENC_CB VOBU_ENT コールバック閱数の定義 

GOP 完結モードでの情報を取得するためのコールバック関数 

VOID CALLBACK VobuProc(UINT enc id, ENC VOBU ENT INFO* pVobu ent, 


encid 

pVobuent 

BoundaryFlag 

UINT Boundary Flag); 

エンコーダの識別子 

ENC VOBU ENT INFO 構造体へのポインタ 
常に 0 が返さまち 


ENC_VOBU_ENT INFO 構造体の定義 

GOP 完結モードでの情報が格納される。 


typedei struct { 


USHORT 

FstrefSz; 

USHORT 

Vobu Pb Tm; 


ULONG Vobu_Sz; 

} ENC VOBU ENT INFO; 


FstrefSz 

VobuPbTm 

VobuSz 

完結単位中の最初の I ピクチャの七クタ (PCK) 数。オーディオ•パック (A PCK) を含む。 
完結単位の再生時間(単位:ビデオ.フィールド数） 

完結単位の七クタ (PCK) 数 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

1補足1 



• ENC_CB ERROR で定義した コールバック 関数は、 エンコード 中に エラーが 発生した場合に 
実行されます。関数を実行して ENC _ rAIL が戻り値として返された場合は、 
ENC_Get Last Error により エラー 情報を取得してください。 

参照 

ENC Get Last Error 
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ENCCanlnitialize 


エンコーダを初期化できるか調べます。 


I 書す I 

ENC_RETURN ENC _ Can _ Initialize(UINT encjd ); 


I 引数 I 

enc id エンコーダ の 識別子 


戻り値 

エンコーダの初期化が可能な場合 ENC_SUCCESS 

すでに使用しているかエンコーダを初期化できない場合 ENC FAIL 
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ENCGetCodecConfig 


カードに関する情報を取得します。 


I 書对 

ENC_RETURN ENC_Get_Codec_Config (UINT encjd ， ENC_CONFIG *pConfig); 


I 引数 I 

encjd エンコーダの識別子 

pConfig 情報を取得ずる ENC_CONFIG 構造体へのポインタ 

ENC_CONFIG 構造体の定義 

カードに関する情報を取得する。 

typedei struct { 

UINT NumberCodecs; 

UINT CodecNumber; 

UINT CodecCaps; 

UINT CurrentUtilization; 

} ENC_CONFIG; 


NumberCodecs 装着されてレ、るカード枚数が格納される。 

CodecNumber 0 または情報を取得したいカード番号 (1 〜 NumberCodecs) を指定する。 

CodecCaps CodecNumber で指定したカードに関する詳細情報フラグが格納される。 


値 

意巧 

ENCCAP NONE 

情報がないことを示すフラグ 

ENCCAP ENCODE 

エンコードが 可能であることを示すフラグ 

ENCCAP DECODE 

デコードが 可能であることを示すフラグ 

ENCCAP MONITOR 

モニタが可能であることを示すフラグ 

ENCCAP AVI2MPEG 

AVI ファイルを MPEG に変换可能であることを示 
すフラグ 

ENCCAP D 2200 

MVR-D2200 であることを示すフラグ 

ENCCAP D 220 OV 

MVR-D 2200 であることを示すフラグ 


CurrentUtilization CodecNumber で指定したカードが使用状況が格納される。 


値 

意み 

TRUE 

使用している 

FALSE 

使用していない 


戻り値 

成功 ENC_SUCCESS 
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失敗 ENC_FAIL 

r 補足] 

ENC _ CONFIG 構造体の CodecNumb げに〇を指定すると、装着されているカード枚数と現在使 
用しているカード番号を取得できます。カードか数は NumberCodecs に格納されます。カード番号 
は CodecNumber に格納されます。カードが使用されていない場合は CodecNumber に0が格納 
されます。 
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ENC Set Codec Number 


使用するカード番号を設定します。 

「害式 I 

ENC_RETURN ENC_Set Codec_Number(UINT encjd , UINT nNumber); 


1 引数 1 

encid 

nNumber 

エンコーダの 識別子 
使用するカード番号 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

1補足1 



• ENCJnitialize または ENC_Initialize_Ex による初期化を行う前に ENC_Se し Codec_Number 

を実行してください。初期化を行う前に ENC_Set Codec_Number を実行しない場合は、自動 
的に使用可能なカードを探して初期化を行います。 

参指定できるカード番号は、 1 から ENC_Get_Codec_Config で取得した ENC_CONFIG 構造体 
の NumberCodecs までの値です。 

• カード番号に0を指定した場合は、初期化時に自動的に使用可能なカードを探します。 

参照 

ENC Get Codec Config, ENC Initialize, ENC Initialize Ex 
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ENC Initialize 


エンコーダの初期化を行ないます。エンコードの種類は、ファイルへのエンコードになります。 

ENC RETURN ENC Initialize(UINT enc id); 


1 引数 1 

encid 

エンコーダの識別子 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENC Initialize Ex 


エンコーダの初期化を行ないます。同時にメディアの設定とメモリ転送時の設定を行います。 


I 書对 

ENC_RETURN ENC_Initialize_Ex(UINT encjd, ENC_MEDIA media, 

ENC_BSS_PARAMETER* pParam); 


引数 


encid エンコーダの識別子 

media エンコードの種類 


値 

意ホ 

ENC MEDIA FILE 

ファイルへのエンコード 

ENC MEDIA MEMORY 

メモリ転送 


pParam メモリ転送用パラメータを設定する ENC_BSS_PARAMETER 構造体のポインタ 

pParam は、 media が ENC_MEDIA MEMORY の場合に設定する。 

それが外の場合は、 NULL を指定する。 


ENC_BSS_PARAMETER 構造体の定義 

メモリ転送用パラメータ情報を設定する。 

typedei struct { 

ENC_BSS_TYPE 
ENC_CB BSS 
DWORD 
DWORD 
DWORD 

} ENC_BSS_PARAMETER; 

fType 予約 ENC_BSS_TYPE_PS を渡す 
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pfnCallback; 

cbBuff; 

cBuff; 

dwData; 
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ENC_CB_BSS コールバック関数の定義 

エンコードデータを 転送す るためのコールバック 関数 

VOID CALLBACK BssProc(LPBYTE pbBuff, DWORD cbBuff, DWORD dwData); 
pbBuff エンコードデータが 格納されている バッファの ポインタ 

cbBuff エンコードデータの サイズ 

dwData ENC BSS PARAMETER 構造体で設定された dwData の値 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

捕足 



• エレメンタリストリームでメモリ転送を行なう場合の設定は、 ENC_Se し BSS_Paramete し AV を 
使用してください。 

• Video CD モードでのメモリ転送は行なえません。 


参照 

ENC Set VideoCD Mode, ENC Set BSS Parameter AV 
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ENC Terminate 


エンコーダを 終了します。 

ENC_RETURN ENC _ Terminate(UINT encjd ); 


1引数1 

encid 

エンコーダの識別子 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

補足 



• ENC _ Terminate 実行後、 ENC _ Set _ Callback によるコールバックの設定は全て解除されます。 
参照 

ENC Set Callback 
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ENC Get Media 


エンコードの 種類を取得します。 

I 書す I 

ENC RETURN ENC Get MediafUINT enc id, ENC MEDIA* media); 


1 引数 1 

encid 

media 

エンコーダの識別子 

エンコードの 種類を取得す る ENC_MEDIA へのポインタ 

戻り 値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 

ENC Initialize Ex 
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ENC Set Media 


エンコードの種類を設定します。 

I 書す I 

ENC RETURN ENC Set Media(UINT enc id, ENC MEDIA media); 


1 引数 1 

encid 

media 

エンコーダの識別子 
エンコードの 種類 

戻り 値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 

ENC Initialize Ex 
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ENC Can Record 


エンコードが 可能か判断します。 

ENC RETURN ENC Can Record(UINT enc id); 


1 引数 1 

encid 

エンコーダの識別子 

戻り値 

エンコード 可能 
エンコード 不可能 

ENC_SUCCESS 

ENC FAIL 
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ENC_Get_Status 


エンコーダの 内部状態を取得します。 


I 書す I 

ENC_RETURN ENC_Get Status(UINT encjd, ENC_STATUS* status); 


引数 


enc id エンコーダ の 識別子 

status エンコーダの内部状態を取得する ENC STATUS へのポインタ 


値 

意ホ 

ENC-STATUS-WAITINITIALIZE 

初期化待ち状態 

ENC STATUS WAITTERMINATE 

終了待ち状態 

ENC STATUS STOP 

停止中 

ENC STATUS MOVIE 

エンコ 1 ー ド中 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENCCanOverlayWindow 


オーバーレイウィンドウを使用できるかどうか判断します。 


I 書す I 

ENC_RETURN ENC_Can Overlay Window(UINT encjd, HANDLE hMonitor, 

UINT nWidth, UINT nHeight); 


1 引数 1 

enc id 

エンコーダの識別子 

hMonitor 

モニタハンドル 

nWidth 

オーバーレイウインドウの 幅 

nHeight 

オーノくー レイウインドウの高さ 

戻り 値 



オーバーレイウィンドウが使用できる場合は、 eNC_SUCCESS 
オーバーレイウインドウが使用できなければ、 ENC FAIL 


I 補足 I 

参 hMonitor には、マルチモニタでのプライマリまたは七カンダリのモニタハンドルを設定します。 
マルチモニタでない場合は、 hMonitor に NULL を設定します。 
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ENCCreateOverlayWindow 


オーバーレイウィンドウを生成します。 

I 書す I 

ENC_RETURN ENC_Create_Overlay_Wmdow(UINT encjd, HWND hWndParent ， HWND* 
hWndOverlay, int x, int y, UINT nWidth, UINT nHeight); 


1引数1 

encid 

hWndParent 

hWndOverlay 

X 

ェンコーダの識別子 

オーバーレイウインドウを生成するウインドウのハンドル 
オーバーレイウインドウのハンドルを取得するアドレス 
オーノくーレイウインドウの位置(左） 

y 

nWidth 

nHeight 

オーノくー レイウインドウの位置（上） 

オーバーレイウインドウの幅（最大 720) 

オーバーレイウインドウの高さ（最大 NTSC 480、 PAL 576) 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 


I 補足 I 

• オーバーレイウィンドウ生成時は、サイズが制限されますが、生成後 
ENC_Resize_Overlay_Window 行により制限な上のサイズを指定できます。 

• エンコード中は生成できません。 

参照 

ENC Resize Overlay Window 
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ENCDestroyOverlayWindow 


オーバーレイウィンドウを破棄します。 

ENC RETURN ENC Destroy Overlay Window(UINT enc id); 


1 引数 1 

encid 

エンコーダの識別子 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

補足 



エンコード 中は破棄できません。 
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ENC Move Overlay Window 


オーノくー レイウィンドウを移動します。 

ENC RETURN ENC Move Overlay_Wmdow(UINT enc id ， INTx ， INTy); 


1 引数 1 

encid 

X 

エンコーダの識別子 

オーバーレイウインドウの左上隅のスクリーン X 座標 

y 

オーバーレイウインドウの左上隅のスクリーン y 座標 

戻り 値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENCResizeOverlayWindow 


オーバーレイウィンドウのサイズを変更します。 

I 書す I 

ENC RETURN ENC Resize Overlay Window(UINT enc id, UINT nWidth, UINT nHeight); 


1 引数 1 

encid 

nWidth 

nHeight 

エンコーダの 識別子 
オーバーレイウインドウの 幅 
オーバーレイウインドウの 高さ 

戻り 値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENCShowOverlayWindow 


オーバーレイウィンドウの表示状態を切り換えます。 


I 書す I 

ENC_RETURN ENC_Show_Overlay Window(UINT encjd, BOOL 松 how); 


引数 


enc id エンコーダ の 識別子 

仪 how ォ '— バ ’— レイウィンドウの表示/非表示 


値 

説明 

TRUE 

表示 

FALSE 

非表示 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENCGetOverlayWindow 


オーバーレイウインドウのハンドルを取得します。 

I 書す I 

ENC RETURN ENC Get Overlay Window(UINT enc id, HWND* pWnd); 


1 引数 1 

encid 

pWnd 

エンコーダの識別子 

オーバーレイウインドウのハンドルを取得するアドレス 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENCGetOverlayRect 


オーノくーレイウインドウの表不領域を取得します。 

I 書す I 

ENC RETURN ENC Get Overlay Rect(UINT enc id, LPRECT pRect); 


1 引数 1 

encid 

pRect 

エンコーダの識別子 

オーバーレイウィンドウの表示領域を取得する RECT 構造体へのポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENCSetOverlayRect 


オーノくーレイウインドウの表不領域を設定します。 


I 書す I 

ENC RETURN ENC Set Overlay Rect(UINT enc id, LPRECT pRect); 


I 引数 I 

enc id エンコーダ の 識別子 

pRect オーバーレイウィンドウの表示領域を設定した RECT 構造体へのポインタ 


戻り値 

成功 ENC_SUCCESS 

失敗 ENCFAIL 


I 捕足 I 

• pRect で設定可能な範囲は次のとおりです。 


ビデホフオーマット 

水平位置 

垂直位置 

NTSC 

〇 〜720 

〇 〜480 

PAL 

〇 〜720 

〇 〜576 


参エンコード中は設定できません。 
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ENCStar し Monitor 


モニタを開始します。 


I 書す I 

ENC_RETURN ENC_Star し Momtor(UINT encjd); 


I 引数 I 

enc id エンコーダ の 識別子 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 


I 補足 I 

参 ENC_Star し Monitor を実行すると、オーバーレイウィンドウは生成時のサイズに戻ります。 
参エンコード中は開始できません。 
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ENCStopMonitor 


モニタを停止します。 

ENC_RETURN ENC_Stop_Monitor(UINT encjd); 


1 引数 1 

encid 

エンコーダの識別子 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 


補足 I 

> ェンコード中は停止できません。 
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ENCGetMonitorStatus 


モニタの状態を取得します。 


I 書す I 

ENC_RETURN ENC_Get Monitor Status(UINT encjd, UINT* monitor); 


引数 


enc id エンコーダ の 識別子 

monitor モニタのが態を取得するアドレス 


値 

説明 

TRUE 

モニタ中である 

FALSE 

モニタ中でない 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENC _ Get _ VideoCD_Mode 


Video CD モードに設定されているか調べます。 


I 書对 

ENC_RETURN ENC_Get VideoCD Mode(UINT encjd，LPINT IpbEnable ); 


引数 


encid エンコーダ の 識別子 

IpbEnable Video CD モードに設定されているかを調べるための値を取得するアドレス 


値 

説明 

TRUE 

Video CD モードである 

FALSE 

Video CD モードでない 


戻り値 
成功 

ENC 

SUCCESS 

失敗 

ENC 

FAIL 

参照 




ENC _ Se し VideoCDMode 
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ENC_Set_VideoCD_Mode 


Video CD モードに設定します。 


I 書す I 

ENC_RETURN ENC_Set VideoCD Mode(UINT encjd, INT bEnable); 


引数 1 


encid 

エンコーダの識別子 

bEnable 

Video CD モードを設定する 

戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

捕足 



参 Video CD モードを有劾にすると、エンコード開始時にな下の値が自動的に設定されます。 


項目 

値 

MPEG の種類 

MPEG1 

ビデオ入カフォーマット 

SIF 

ビデオ入カサイズ 

NTSC 352X240 

PAL 352X288 

ビデオビットレート 

1150000 bps 

CBR/VBR 

CBR 

オーデイオビットレート 

224000 bps 

サンプリングレート 

44100 Hz 

レイヤ 

レイヤ n 

オーディオモード 

モノラルな外（モノラルに設定されている場合 
は、ステレオに変更されます。） 

エンファシス 

CCITT な外 （ CCITT に設定されている場合 
は、無しに変更されます。） 

GOP 完結モード / GOP 非完結モード 

GOP 非完結モード 


参照 

ENC_Get_VideoCD_Mode,ENC_Get_Video_Encode_Parameter, ENC Get Audio Parameter, 
ENC Get Audio Encode Parameter 
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ENC Get BSS Parameter 


メモリ転送用パラメータを巧得します。 

I 書す I 

ENC RETURN ENC Get BSS ParameterfUINT enc id, 



ENC_BSS_PARAMETER* pParam); 

1 引数 1 

encid 

pParam 

エンコーダの識別子 

メモリ転送用パラメータを取得する ENC_BSS_PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 

ENC Initialize Ex 
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ENC Set BSS Parameter 


メモリ転送用パラメータを設定します。 

「害式 I 

ENC_RETURN ENC_Set BSS_Parameter(UINT encjd, 



ENC_BSS_PARAMETER* pParam); 

1 引数 1 

encid 

pParam 

エンコーダの識別子 

メモリ転送用パラメータを設定する ENC_BSS_PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 

ENC Initialize Ex 
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ENC Get BSS Parameter AV 


エレメンタリストリームでのメモリ転送用パラメータを取得します。 

I 書す I 

ENC RETURN ENC Get BSS Parameter AV(UINT enc id, 



ENC_BSS_PARAMETER* pParamAudio, 

ENC_BSS_PARAMETER* pParamVideo); 

1 引数 1 

encid 

pParamAuaio 

エンコーダの識別子 

オーディオのメモリ転送用パラメータを取得する ENC BSS PARAMETER 
構造体のポインタ 

pParamVideo 

ビデオのメモリ転送用パラメータを取得する ENC_BSS_PARAMETER 構造 
体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 


I 補足 I 

• エレメンタリストリームのメモリ転送では、 ENC_BSS_PARAMETER 構造体の fType メンバは 
使用しません。 

参照 

ENC Initialize Ex 
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ENC Set BSS Parameter AV 


エレ メンタリストリームでのメモリ転送用パラメータを設定します。 

「害式 I 

ENC_RETURN ENC_Set BSS_Parameter AV(UINT encjd, 



ENC_BSS_PARAMETER* pParamAudio, 

ENC_BSS_PARAMETER* pParamVideo); 

1 引数 1 

encid 

pParamAuaio 

エンコーダの識別子 

オーディオのメモリ転送用パラメータを設定する ENC_BSS_PARAMETER 構造体の 
ポインタ 

pParamVideo 

ビデホのメモリ串云送用パラメータを設定する ENC_BSS_PARAMETER 構造体のポイ 
ンタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 


I 補足 I 

参エレメンタリストリームのメモリ転送では、 ENC_BSS_PARAMETER 構造体の fType メンバは 
使用しません。 

参照 

ENC Initialize Ex 
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ENCGetOverlayParameter 


オーバーレイ表示パラメータを取得します。 


I 書对 

ENC_RETURN ENC_Get Overlay Parameter(UINT encjd ， 

ENC_OVERLAY PARAMETER* pParam); 


I 引数 I 

encid エンコーダの識別子 

pParam ホーバーレイ表示パラメータを取得する 

ENC_OVERLAY PARAMETER 構造体のポインタ 


ENC_OVERLAY PARAMETER 構造体の定義 

オーバーレイ表示パラメータ情報が格納される。 

typedei struct { 


UINT 

nOverlay け rightness; 

int 

nOverlayContrast; 

int 

nOverlaySaturation; 


} ENC OVERLAY PARAMETER; 


nOverlayBrightness 巧るさの値が格納される。 


値 

説明 

ENCMIN VIDEO OVERLAY BRIGHTNESS 

最小値 

ENCMAX VIDEO OVERLAY BRIGHTNESS 

最大値 

ENCDEF VIDEO OVERLAY BRIGHTNESS 

デフォルト値 


nOverlayContrast コントラストの値が格納される。 


値 

説明 

ENCMIN VIDEO OVERLAY CONTRAST 

最小値 

ENCMAX VIDEO OVERLAY CONTRAST 

最大値 

ENCDEF VIDEO OVERLAY CONTRAST 

デフォルト値 

nOverlaySaturation 色の濃さの値が格納を 

化。 

値 

説明 

ENCMIN VIDEO OVERLAY SATURATION 

最小値 

ENCMAX VIDEO OVERLAY SATURATION 

最大値 

ENCDEF VIDEO OVERLAY SATURATION 

デフォルト値 
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戻り値 

成功 ENC_SUCCESS 

失敗 ENC_FAIL 
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ENCSetOverlayParameter 


オーバーレイ 表示 パラメータを 設定します。 

ENC RETURN ENC Set Overlay Parameter(UINT enc id, 



ENC_OVERLAY PARAMETER* pParam); 

1 引数 1 

encid 

pParam 

エンコーダの識別子 

才 ' ーノス ' ーレイ表示パラメ'ータを設をする 

ENC_OVERLAY PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 




参照 

ENCGetOverlayParameter 


canopus 


74 



















MV 民 Series Development Kit 


ENC Get Video Parameter 


ビデオパラメータを取得します。 


I 書对 

ENC_RETURN ENC_Get_Video_Parameter(UINT encjd, 

ENC_VIDEO PARAMETER* Video_Param); 


I 引数 I 

encid エンコーダ の 識別子 

Video_Param ビデホパラメータを取得する ENC_VIDEO_PARAMETER 構造体のポインタ 

ENC_VIDEO PARAMETER 構造体の定義 
ビデオパラメータ情報が格納される。 

typedei struct { 


int 

TVSystem; 

int 

fInputSource; 

UINT 

nInputB rightness; 

int 

nInputContrast; 

int 

nInputHue; 

int 

nInputSatura 村 on; 

BOOL 

fOutputMonitor; 


} ENC VIDEO PARAMETER; 


TV System 放送規格の種類が格糸 

ちされる。 

値 

説明 

ENC VIDEO TV SYSTEM NTSC 

NTSC 

ENC VIDEO TV SYSTEM PAL 

PAL 


打叩 utSource 入カソースの種類が格納される。 


値 

説明 

ENC VIDEO INPUT SOURCE COMPOSITE 

Composite 

ENC VIDEO INPUT SOURCE SVIDEO 

S-Video 


nInputBrightness ビデオ入力の明るさの . 

直が格納される。 

値 

説明 

ENCMIN VIDEO INPUT BRIGHTNESS 

最小値 

ENCMAX VIDEO INPUT BRIGHTNESS 

最大値 

ENCDEF VIDEO INPUT BRIGHTNESS 

デフォルト値 
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nl 叩 utContrast ビデオ入力のコントラストの値が格納される。 


値 

説明 

ENCMIN VIDEO INPUT CONTRAST 

最小値 

ENCMAX VIDEO INPUT CONTRAST 

最大値 

ENCDEF VIDEO INPUT CONTRAST 

デフォルト値 


nInputHue ビデオ入力の色合いの値が格納される。 


値 

説明 

ENCMIN VIDEO INPUT HUE 

最小値 

ENCMAX VIDEO INPUT HUE 

最大値 

ENCDEF VIDEO INPUT HUE 

デフォルト値 


nl 叩 utSaturation ビデホ入力の色の濃さの値が格納される。 


値 

説明 

ENCMIN VIDEO INPUT SATURATION 

最小値 

ENCMAX VIDEO INPUT SATURATION 

最大値 

ENCDEF VIDEO INPUT SATURATION 

デフォルト値 


fOutputMonitor ビデホ出力が態が格納される。 


値 

説明 

TRUE 

ビデホ出力 ON 

FALSE 

ビデオ出力 OFF 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENC Set Video Parameter 


ビデオ • パラメータを設定します。 


書式 1 


ENC_RETURN ENC_Set_Video_Parameter(UINT encjd, 

ENC_VIDEO PARAMETER* Video_Param); 

引数 1 

encid 

エンコーダの識別子 

VideoParam 

戻り値 

ビデオパラメータを設定する ENC VIDEO PARAMETER 構造体のポイン 
夕 - - 

成功 

ENC_SUCCESS 

失敗 

捕足 

ENC_FAIL 


• モニタ中に ENC_VIDEO PARAMETER 構造体のが下のメンバの値を変更する場合は、 

ENC Stop Monitor によりモニタを停止させてから ENC Set Video Parameter により値を変 

要します。モニタを再開する場合は、この後に ENC Start Monitor を巧ないます。 


TVSystem 
な nputSource 
fOutputMonitor 


• デジタル • ビデオ入力の時は、 ENC_VIDEO_R4RAMETER 構造体のが下のメンバについて 
設定は可能ですが、反映はされません。 

• TVSystem 

• flnputSource 

• nlnputBnghtness 

• nInputContrast 

• nlnputHue 

• nlnputHue 

• nlnputSaturation 
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参照 

ENC Get Video Parameter, ENC Star し Monitor, ENC Stop Monitor, 
ENC Set Digital Video Input, ENC Get Digital Video Input 
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ENC Get Video Parameter] 


ビデオパラメータ 2 を取得する。 


I 書对 

ENC_RETURN ENC_Get_Video_Parameter2(UINT encjd, 

ENC VIDEO PARAMETER]* Video Param); 


I 引数 I 

encid エンコーダの識別子 

Video Param 拡張ビデホ パラメータ 2 を取得する 

ENC_VIDEO PARAMETER2 構造体のポインタ 

ENC_VIDEO PARAMETER2 構造体の定義 

拡張ビデオパラメータ 2 情報が格納される。 

typedei struct { 

DWORD 

ENC_VIDEO PARAMETER 
int 

} ENC_VIDEO PARAMETER2; 

dwSize ENC_VIDEO PARAMETER2 

構造をのサイタを指定してください。 

dwSize = sizeof(ENC_VIDEO PARAMETER2) 
EncVideoParam ビデオパラメータ情報が格納される 


nVideoProcessing ビデホプロセッシングの設定状負 

旨が格納される。 

値 

説明 

ENC_VIDEO PROCESSING_3DYC 

3 次元 YC 分離を使用します。 

コンポジット入力時のみ有効です。 

ENC VIDEO PROCESSING NONE 

ビデオプロセッシングを使用しません 

ENC VIDEO PROCESSING NR W 

ノイズリダクション弱を使用します。 

ENC VIDEO PROCESSING NR S 

ノイズリダクション強を使用します。 


戻り値 
成功 

ENC 

SUCCESS 

失敗 

ENC 

FAIL 

参照 




ENC Get Video Parameter 
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I 補足 I 

#ENC_VIDEO PARAMETER2 の nVideoProcessing メンバは MVR-D2200 専用です。 
MVR-D2200 でない場合は使用しても何も反映されません。 

•ENC_VIDE0_PARAMETER2 構造体については、今後必要に応じてパラメータが拡張される 
場合があります。 
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ENC Set Video Parameter! 


ビデオパラメータ 2 を設定します。 


I 書对 

ENC_RETURN ENC_Set_Video_Parameter2(UINT enc_id ， 

ENC VIDEO PARAMETER!* Video Param); 


I 引数 I 

encid エンコーダの識別子 

Video Param ビデホパラメータ 2 を設定する 

ENC VIDEO PARAMETER2 構造体のポインタ 


戻り値 
成功 

ENC 

SUCCESS 

失敗 

ENC 

FAIL 

参照 




ENC Get Video Parameter2 
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ENC Get Video Encode Parameter 


ビデオ エンコード 用パラメータを取得します。 


I 書す I 

ENC_RETURN ENC_Get Video_Encode_Parameter(UINT encjd, 

ENC_VIDEO ENCODE PARAMETER* Video Param); 


I 引数 I 

enc id エンコーダ の 識別子 

Video_Param ビデオエンコード用パラメータを取得する ENC_VIDEO_ENCODE_PARAMETER 構 

造体のポインタ 


ENC_VIDEO ENCODE PARAMETER 構造体の定義 


ビデオ エンコ、 

ード用パラメータ情報が格納される , 

typedei struct { 


int 

VCodingMode; 

DWORD 

fProfileAndLevel; 

DWORD 

fConvertType; 

WORD 

wlmageLeft; 

WORD 

wlmageiop; 

WORD 

wImageWidth; 

WORD 

wImageHeight; 

DWORD 

dwBitrate; 

int 

EncodeType; 

int 

GopPattern; 


} ENC VIDEO ENCODE PARAMETER; 


V CodingMode MPEG の種類が格納される。 


値 

説明 

ENCVEPARAM V CODING MODE MPEGl 

MPEGl 

ENCVEPARAM V CODING MODE MPEGl 

MPEG2 


fProfileAndLevel プロファイルとレベルの種類が格納される。 


MPEG1 では使用しません。 


値 

説明 

ENCVEPARAM PROFILE AND LEVEL MP ML 

MP@ML 

ENCVEPARAM PROFILE AND LEVEL MP LL 

MP@LL 

ENCVEPARAM PROFILE AND LEVEL SP ML 

SP@ML 
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fConvertType ビデオ入カフォーマットの種類が格納される。 


MPEG1 の場合は、 SIF 固定 

こなります。 

値 

説明 

ENCVEPARAM CONVERT TYPE STANDARD 

Standard ( 幅 1 X 高さ 1) 

ENCVEPARAM CONVERT TYPE SIF 

SIF ( 幅 1/2 X 高さ 1/2) 

ENCVEPARAM CONVERT TYPE HALF D1 

Half-Dl ( 幅 1/2 X 高さ 1) 


wImageLeft 予約 0 を渡す。 

wImageTop 予約 0 を渡す。 

wImageWidth ビデオ入カサイズ ( 幅）が格納される。 


設定時は、 16 画素の整数倍を指定する。 


wImageHeight ビデオ入カサイズ楠さ）が格納される。 

設定時は、 16 画素の整数倍を指定する。 


MPEG の種類 

プロファイルと 
レベル 

ビデオ入力 

フホ^—マット 

ビデオ入カサイズ 

NTSC 

PAL 

MPEG1 

設定不可 

SIF 

352X240 

352X288 

MPEG2 

MP@ML 

Standard 

720X480 

720X576 

SIF 

352X240 

352X288 

Half-Dl 

352X480 

352X576 

MP@LL 

SIF 

352X240 

352X288 

SP@ML 

Standard 

720X480 

720X576 

SIF 

352X240 

352X288 

Half-Dl 

352X480 

352X576 


dwBitrate 平巧ビデオビットレートの値ボ格納される。（単位 : bps) 

設定時は、 400bps の整数倍を指定する。 


MPEG の種類 

プロファイルと 
レベル 

ビデホ入力 

フ ホー マット 

平均ビデオビットレートの設定範囲 

MPEGl 

設定不可 

SIF 

1 ， 000,000 〜 1 ， 800,000 bps 

MPEG1(Video CD) 

設定不可 

SIF 

1 ， 150 ク 00 bps のみ 

MPEGl 

MP@ML 

Standard 

4,000,000 〜 15,000,000 bps 

SIF 

2,000,000 〜 8,000,000 bps 

Half-Dl 

2,000,000 〜 8,000,000 bps 

MP@LL 

SIF 

2,000,000 〜 4,000,000 bps 

SP@ML 

Standard 

4,000,000 〜 15,000,000 bps 

SIF 

2,000,000 〜 8,000,000 bps 

Half-Dl 

2,000,000 〜 8,000,000 bps 


EncodeType CBR/VBR の選択状態が格納される。 


値 

説明 

ENCVEPARAM ENCODE TYPE CBR 

CBR 

ENCVEPARAM ENCODE TYPE VBR 

VBR 
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G 冲 Pattern GOP パターンの選択状態が格納される。 


値 

説明 

ENCVEPARAM GOP PATTERN IFRAME 

I Frame 

ENCVEPARAM GOP PATTERN IBBP 

IBBP 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENC Set Video Encode Parameter 


ビデオ エンコード 用 パラメータを 設定します。 


I 書す I 

ENC_RETURN ENC_Set Video_Eiicode_Parameter(UINT encjd, 

ENC_VIDEO ENCODE PARAMETER* Video Param); 


I 引数 I 

enc id エンコーダの識別子 

Video_Param ビデオエンコード用パラメータを設定する ENC_VIDEO_ENCODE_PARAMETER 構 

造体のポインタ 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

捕足 



参 ENC_Se し Video_Encode_Parameter を実行すると、な下の値が自動的に設定されます。 


設定項目 

値 

I Frame 

IBBP 

SP@ML な外 

SP@ML 

GOP 内のピクチャか数 

1 

15 

15 

GOP 巧の I ピクチャまたは P ピクチャが現 
れる周期 

1 

3 

1 

VBR での最大ビデオビットレート 

ビデオビットレート 
の 2 倍 

現在の設定 

ビデオエレメンタリストリームに対する 

Closed GOP の設定 

OFF 

アスペクト比 

4:3 


参照 

ENC Get Video Encode Parameter, ENC Get Video Encode Parameter Ex 
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ENC Get Video Encode Parameter Ex 


拡張ビデオ エンコード 用 パラメータを 取得します。 


I 書对 

ENC_RETURN ENC_Get_Video_Encode_Parameter_Ex(UINT encjd ， 

ENC VIDEO ENCODE PARAMETER EX* Video Param); 


I 引数 I 

encid エンコーダ の 識別子 

Video_Param 拡張ビデホ エンコード 用パラメータを取得する 

ENC_VIDEO ENCODE PARAMETER EX 構造体のポインタ 

ENC_VIDEO ENCODE PARAMETER EX 構造体の定義 
拡張ビデオ エンコード 用 パラメータ 情報が格納される。 

typedei struct { 

ENC_VIDEO ENCODE PARAMETER 
WORD 
WORD 
WORD 
BOOL 
BOOL 
WORD 
BOOL 

} ENC_VIDEO ENCODE PARAMETER EX; 


EncodeParam ビデオ エンコード 用パラメータ情報が格納される。 

cPictureInterval GOP 内の I ピクチャまたは P ピクチャが現れる周期が格納される。 


値 

説明 

ENCVEPARAMEX MIN PICTURE INTERVAL 

最小値 

ENCVEPARAMEX MAX PICTURE INTERVAL 

最大値 


cPicturePerGop GOP 内のピクチャ枚数が格納される。 


値 

説明 

ENCVEPARAMEX MIN PICTURE PER GOP 

最小値 

ENCVEPARAMEX MAX PICTURE PER GOP 

最大値 
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EncodeParam; 

cPictureInterval; 

cPicturePerGop; 

dwVbrPeak; 

fClosedGop; 

fGopComplete; 

wAspectRatio; 

fLowDelay; 
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dwVbrPeak VBR での最大ビデオビットレートが格納される。（単位 : bps) 


MPEG の種類 

最大ビデオビットレートの設定範困 

MPEGl 

平均ビデオビットレートの設定値〜 1 ， 800,000 bps 

MPEGl (Video CD) 

設定不可 

MPEG2 (MP@ML) 

平均ビデオビットレートの設定値〜 15,000,000 bps 

MPEGl (MP@LL) 

平均ビデオビットレートの設定値〜 4,000,000 bps 

MPEG2(SP@ML) 

平均ビデオビットレートの設定値〜 15,000,000 bps 


fClosedGop ビデオエレメンタリストリームにかする Closed GOP の設定状態が格納される。 


値 

説明 

TRUE 

ON 

FALSE 

OFF 

fGopComplete GOP 完結プログラムストリームのイノ 

戸成状態が格納される。 

値 

説明 

TRUE 

GOP 完結モード 

FALSE 

GOP 非完結モード 


wAspectRatio アスペクト比の値が格納される。 


値 

説明 

ENCVEPARAMEX ASPECT RATIO 4 3 

4:3 

ENCVEPARAMEX ASPECT RATIO16 9 

16:9 


fLowDelay Low Delay の設定が : 態が格納される。 


値 

説明 

TRUE 

ON 

FALSE 

OFF 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

捕足 



• ENC_VIDEO ENCODE PARAMETER EX 構造体については、今後必要に応じてパラメ 
ータがお張される場合があります。 


参照 

ENC Get Video Encode Parameter 
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ENC Set Video Encode Parameter Ex 


あ張ビデオ エンコード 用 パラメータを 設定します。 


I 書す I 

ENC_RETURN ENC_Set Video_Encode_Parameter Ex(UINT encjd, 

ENC_VIDEO ENCODE PARAMETER EX* Video_Parain); 


I 引数 I 

enc id エンコーダの識別子 

Video Param 拡張ビデオ エンコード 用 パラメータを 設定する 

ENC VIDEO ENCODE PARAMETER EX 構造体のポインタ 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

捕足 



• ENC_VIDEO ENCODE PARAMETER EX 構造体の fGopComplete により GOP 完結プロ 

グラムストリームを作成する設定を行なった場合、な下の項目に固定値が設定されます。 


設定項目 

値 

レイヤ 

レイヤ n 

サンプリング周波数 

48kHz 


• ENC_VIDEO ENCODE PARAMETER EX 構造体の wAspectRatio により TRUE を設を 

した場合、表示領域サイズの情報がビデオエレメンタリストリーム巧に付加されます。この情報 
は MPEG1 では付加されません。 


画像サイズと表示領域サイズの関係はかのようになります。 


ビデオ フォーマット 

画像サイズ 

表示領域サイズ 

NTSC Standard 

720X480 

540X480 

NTSC SIF 

352X240 

264X240 

NTSC Half-Dl 

352X480 

264X480 

PAL Standard 

720X576 

540X576 

PAL SIF 

352X288 

264X288 

PAL Half-Dl 

352X576 

264X576 
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• ENC_VIDEO ENCODE PARAMETER EX 構造体の fLowDelay により Low Delay を ON 

にする設定を行なった場合、同じく構造体の cPicturelnterval は 
ENCVEPARAMEX MIN PICTURE INTERVAL に設定されます。 


参照 

ENC Get Video Encode Parameter, ENC Get Video Encode Parameter Ex, 
ENC Get Audio Parameter, ENC Get Audio Encode Parameter 


canopus 


89 







MV 民 Series Development Kit 


ENC Get Video Encode Parameter Ex2 


拡張ビデオエンコード用パラメータ 2 を取得する。 


I 書对 

ENC_RETURN ENC_Get_Video_Encode_Parameter_Ex2(UINT encjd, 

ENC VIDEO ENCODE PARAMETER EX2* Video Param); 


I 引数 I 

encid エンコーダの識別子 

Video Param 拡張ビデホエンコード用パラメータ 2 を取得する 

ENC_VIDEO ENCODE PARAMETER EX2 構造体のポインタ 

ENC_VIDEO ENCODE PARAMETER EX2 構造体の定義 

拡張ビデオ エンコード 用 パラメータ 2 情報が格納される。 

typedei struct { 

DWORD dwSize; 

ENC_VIDEO ENCODE PARAMETER EX EncodeParamEx; 

BOOL fBottomFieldFirst; 

} ENC_VIDEO ENCODE PARAMETER EX2; 

dwSize ENC_VIDEO ENCODE PARAMETER EX2 

構造をのサイ X を指定レ六ださい。 - 

dwSize = sizeof(ENC_VIDEO ENCODE PARAMETER EX2) 
EncodeParamEx 拡張ビデオエンコード用パラメータ情報が格納される 


fBottomFieldFirst 

フィールドオーダーの設定状態が 

格納される。 

値 

説明 

TRUE 

ボトムファースト 

FALSE 

トップファースト 


戻り値 
成功 

ENC 

SUCCESS 

失敗 

ENC 

FAIL 

参照 




ENC Get Video Encode Parameter Ex 


I 補足 I 

•ENC VIDEO ENCODE PARAMETER EX2 構造体については、今後必要に応じてパラメ 
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ータがお張される場合があります。 
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ENC Set Video Encode Parameter Ex2 


お張ビデオ エンコード 用 パラメータ 2 を設定します。 

「害式 I 

ENC RETURN ENC Set Video Encode_Parameter Ex2(UINT enc id, 



ENC_VIDEO ENCODE PARAMETER EX2* Video_Param); 

1 引数 1 

encid 

VideoParam 

エンコーダの識別子 

拡張ビデオエンコード用パラメータ 2 を設定する 

ENC_VIDEO_ENCODE_PARAMETER_EX2 構造体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 



ENC Set Video Encode Parameter Ex 


canopus 


92 



















MV 民 Series Development Kit 


EN CGetAudioF ormat 


オーディオ形式を取得します。 


I 書对 

ENC_RETURN ENC_Get_Audio_Format (UINT encjd, 

ENC_AUDIO FORMAT *pAudioFormat); 


引数 


encid エンコーダの識別子 

pAudioFormat ホーディホ形式を取得するアドレス 


値 

説明 

ENC AUDIO FORMAT MPEG 

MPEG 

ENC AUDIO FORMAT PCM MONO 

PCM モノラル 

ENC AUDIO FORMAT PCM STEREO 

PCM ステレオ 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENC Set Audio Format 


オーディオ形式を設定します。 

ENC_RETURN ENC_Set_Audio_Format(UINT encjd ， 



ENC_AUDIO FORMAT AudioFormat); 

1 引数 1 

encid 

AudioFormat 

エンコーダの 識別子 
オーディオ形式を設定する 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 



ENC Get Audio Format 
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ENC Get Audio Parameter 


オーディオパラメータを 取得します。 


I 書す I 

ENC_RETURN ENC_Get Audio_Parameter(UINT encjd, 

ENC_AUDIO PARAMETER* Audio_Param); 


I 引数 I 

enc id エンコーダ の 識別子 

Audio_Param オーデイオパラメータを取得する ENC_AUDIO PARAMETER 構造体のポインタ 

ENC AUDIO PARAMETER 構造体の定義 


オーデイオハ。ラメ、 

ータ情報が格納される。 

typedei struct { 


DWORD 

dwSamplingFrequency; 

BOOL 

fOutputMonitor; 

BOOL 

fOutputMute; 

DWORD 

dwLeftOutputAtt; 

DWORD 

dwRightOutputAtt; 

int 

nLeftlnputGain; 

int 

nRightInputiiam; 


} ENC AUDIO PARAMETER; 


dwSamplingFrequency サンプリング周波数が格納される。（単位 : Hz) 


設定値 : 32000/44100/48000 

fOutputMonitor オーディオ出力状態が格納される。 


値 

説明 

TRUE 

オーディオ出力 ON 

FALSE 

オーディオ出力 OFF 


fOutputMute ミュート状態が格納される。 


値 

説明 

TRUE 

ミュート ON 

FALSE 

ミュート OFF 
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dwLeftOutputAtt 左の音量が格納さ ; 

化。 


値 


説明 

ENCMIN AUDIO OUTPUT ATT 

最小値 


ENCMAX AUDIO OUTPUT ATT 

最大値 



dwRightOutputAtt 右の音量が格納される。（値は dwLeftOutputAtt と同じ） 

nLeftI 叩 utGain 左のホーデイオ PCM 入力に対'する GAIN が格納される。 


値 

説明 

ENCMIN AUDIO INPUT GAIN 

最小値 

ENCMAX AUDIO INPUT GAIN 

最大値 


nRightlnputGain 右のホーディホ PCM 入力に対する GAIN が格納される。 

(値は nLeftlnputGain と同じ） 


戾り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 


canopus 


96 





















MV 民 Series Development Kit 


ENC Set Audio Parameter 


オーディオパラメータを設定します。 

ENC_RETURN ENC_Set Audio_Parameter(UINT encjd, 



ENC_AUDIO PARAMETER* Audio_Param); 

1 引数 1 

encid 

AudioParam 

エンコーダの識別子 

オーディオパラメータを設定する ENC_AUDIO PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

補足 



• モニタ中に ENC_AUDIO PARAMETER 構造体の dwSamplmgFrequency 、 
fOutputMonitor の値を変更する場合は、 ENC_Stop_Monitor によりモニタを停止させてから 
ENC_Se し Audi ( し Parameter により値を変更します。モニタを再開する場合は、この後に 

ENC_Star し Monitor を行ないます。 

参照 

ENC Get Audio Parameter, ENC Stop JMonitor, ENC Start Monitor 
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ENC Get Audio Encode Parameter 


オーディオエンコード 用 パラメータを 取得します。 


I 書す I 

ENC_RETURN ENC_Get Audio_Encode_Parameter(UINT encjd, 

ENC_AUDIO ENCODE PARAMETER* Audio Param); 


I 引数 I 

enc id エンコーダの識別子 

AudioParam オーディオエンコード用パラメータを取得する 

ENC_AUDIO_ENCODE_PARAMETER 構造体のポインタ 

ENC_AUDIO_ENCODE_PARAMETER 構造 f 本の定義 
オーディオパラメータ 情報が格納され る。 

typedei struct { 


DWORD 

nLayer; 

BOOL 

fProtection; 

int 

AudioBitrate; 

int 

Channel Num; 

DWORD 

fModeEx; 

BOOL 

fC 冲 yright; 

BOOL 

fOriginal; 

BOOL 

fEmphasis; 


} ENC_AUDIO ENCODE PARAMETER; 

nLayer 予狗 ENCAEPARAM LAYER2 を渡す。 


fProtection プロテクションの状態が格納される。 


値 

説明 

TRUE 

エラーチェック有り 

FALSE 

エラーチェック 無し 


canopus 


98 


















MV 民 Series Development Kit 


AudioBitrate オーディオビットレートが格納される。 

ChannelNum プロテクションの状態が格納される。 


値 

説明 

ENCAEPARAM CHANNEL NUM STEREO 

ステレオ 

ENCAEPARAM CHANNEL NUM MONO 

モノラル 

ENCAEPARAM CHANNEL NUM DUAL MONO 

デュアル•チャネル 

ENCAEPARAM CHANNEL NUM JOINT STEREO 

ジョイント•ステレホ 


fModeEx 予狗〇を渡す。 


fCopyright コピーライトの状態ボ格納される。 


値 

説明 

TRUE 

著作権有り 

FALSE 

著作権無し 


fOriginal オリジナル / コピーの状態が格納される。 


値 

説明 

TRUE 

オリジナル 

FALSE 

コピー 


fEmphasis エンフアシス 特性の状態が格納される。 


値 

説明 

ENCAEPARAM EMPHASIS NONE 

無し 

ENCAEPARAM EMPHASIS 5015 

50/15/z s 

ENCAEPARAM EMPHASIS CCITT 

CCITT J.17 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENCSetAudioEncodeParameter 

オーディオエンコード用パラメータを設定します。 

ENC RETURN ENC Set Audio Encode Parameter(UINT enc id, 



ENC_AUDIO ENCODE PARAMETER* Audio_Param); 

1 引数 1 

encid 

AudioParam 

エンコーダの識別子 

オーディオエンコード用パラメータを設定する 

ENC_AUDIO_ENCODE_PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 



ENCGetAudioEncodeParameter 
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ENC Init Movie 


エンコードを開始待ら状態にします。 

ENC RETURN ENC Init Movie(UINT enc id); 


1 引数 1 

encid 

エンコーダの識別子 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENC Record Movie 


エンコードを開始します。 


I 書す I 

ENC_RETURN ENC_Record_Movie(UINT encjd, UINT enc_mode_flag); 


引数 


enc id エンコーダの識別子 

enc mode flag エンコードを行なう種類を設定する 


値 

説明 

ENC RECORD AUDIO 

ホーディホのみ 

ENC RECORD VIDEO 

ビデオのみ（エレメンタリストリーム） 

ENC RECORD AUDIO 1 ENC RECORD VIDEO 

オーディオ+ビデオ 

ENC_RECORD PS 

MPEG1 : システムストリーム 

MPEG2: プログラムストリーム 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

捕足 



• メモリ転送を行なう設定で ENCJnitialize を実行した場合は、次の条件でのエンコードは巧な 
えません。 

① オーデイオ+ビデオの エンコード 

② オーディオ形式を PCM に設定した場合のオーディオのみのエンコード 


参照 

ENC Initialize, ENC Initialize Ex, ENC Get Audio Format, ENC Set Audio Format 
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ENC_Stop 


エンコードを 停止します。 

ENC_RETURN ENC_Stop(UINT encjd); 


1 引数 1 

encid 

エンコーダの識別子 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENCGetBitmapBits 


静止画 ( BMP ) をバッファで取得します。 


書式 


ENC_RETURN ENC_Get BitmapBits(UINT encjd, LPBYTE* IpByte, LPDWORD pdwLen, 
MVRSTILLCAPPARAM pParam); 


I 引数 I 

encid エンコーダの識別子 

IpByte データを格納する バッファへの ポインタを格納するポインタ 

pdwLen 取得した静止画のバイト数を格納するポインタ 

pParam MVRSTILLCAPPARAM 構造体 


MVRSTILLCAPPARAM 構造体の定義 
typedei struct { 

DWORD 

INT 

BOOL 

double 

MVR_UYVY2RGB FUNC 
} MVRSTILLCAPPARAM; 


dwSize; 
nFrameCap; 
fExpandRGB; 
d し orrectGamma; 
pfnuyvy2rgb; 


dwSize この構造体のサイズを指定します。 

dwSize = sizeof(MVRSTILLCAPPARAM) 
nFrameCap フレームの キヤプチ ャ 方法を指定します。 


値 

説明 

MVRSTILL FRAME 

1 フレームをキヤ プ チヤし ます。 

MVRSTILL ODD FIELD 

奇数ラインのみ取得し 2 倍に引き伸ばし 
ます。 

MVRSTILL EVEN FIELD 

偶数ラインのみ取得し 2 倍に引き伸ばし 
ます。 


fExpandRGB TRUE の場合、 YUV 一 RGB 靈換時に、 [235-16] の範囲を [0-255] の範 

囲へ拡大ずる変換を行レ、まず。 

dCorrectGamma ガンマ補正値を設定しまず。標準で NTSC の時 2.2 で PAL の時 2.8 で 

す。使用しないときは1に設定します。 

pfnuyvylrgb 変換を行う関敷を指定できます。指をしない場合は NULL でないといけませ 

ん。 
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MVR _ UYVY 2 RGB_FUNC 関敷の定義 

YUV -> RGB に変換するための関数 

INT ConvertYUVtoRGB ( BYTE ul,BYTE yl，BYTE vl,BYTE y 2, COLORREF * pColorl ， 
COLORREF * pColor 2) 

Ul 変換元輝度信号と赤色成分の差 

yl RGB 1バイト目用の変換元輝度信号 

VI 変換元輝度信号と青色成分の差 

y 2 RGB 2バイト目用の変換元輝度信号 

*pColorl 変換後 RGB 1バイト目 

* pColor 2 変換後 RGB 2バイト目 


I 戻り値 I 

ConvertYUVtoRGB 関数は必ず1を返してください。 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

補足 



• エンコード中でもキヤプチヤ可能です。 

• キヤプチヤ時に映像の DMA の転送を1度止めるので PC 上のオーバーレイの映像が一瞬停 
止します。（外部モニタへ出力されてレ、る映像は停止しません） 

参取得できるサイズはソースサイズです。 ( NTSC : 720 X 480 、 PAL : 720 X 576) 
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ENC Save DIB 


静止画 ( BMP ) をファイルに保存します。 

I 書す I 

ENC_RETURN ENC_Save_DIB(UINT encjd, LPCTSTR IpszFileName, 
MVRSTILLCAPPARAM pParam); 


1引数1 

encid 

IpszFileName 

pParam 

エンコーダの 識別子 
保存するファイルぶ 

静止画キャプチャパラメータを設定する MVRSTILLCAPPARAM 構造体 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 




参照 

ENC _ Ge し BitmapBits の補足を確認してください。 
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ENC Save JPEG 


静止画 (JPEG) をファイルに保存します。 

I 書す I 

ENC_RETURN ENC_Save_JPEG(UINT encjd, LPCTSTR IpszFileName, UINT nQuality, 
MVRSTILLCAPPARAM pParam); 


1 引数 1 

encid 

IpszFileName 

nQuality 

エンコーダの 識別子 
保存するファイルぶ 

JPEG の圧縮率 (0 〜 9 の範囲で指定できます)を指定します。 

0 : 狗 1/5 

1: 約 1/7 

2 : 約 1/10 

3 : 約 1/12 

4 : 約 1/15 

5 : 約 1/17 

6 : ^ 1/20 

7 : ^ 1/25 

8 : 狗 1/30 

9 : 狗 1/40 

pParam 

静止画キャプチャパラメータを設定する MVRSTILLCAPPARAM 構造体 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 




参照 

ENC_Ge し BitmapBits の補足を確認してください 
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ENC Get Record Time 


エンコードを行なう時間を取得します。 

I 書す I 

ENC RETURN ENC Get Record Time(UINT encjd , UINT * rec time , UINT * enabled ); 


1 引数 1 

encid 

rec time 

enabled 

エンコーダの識別子 

エンコードを行なう時間を取得するアドレス 
エンコードを行なう時間制限の状態を取得するアドレス 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC_FAIL 

参照 



ENC Set Record Time 
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ENCSe し Record-Time 


エンコードを行なう時間を設定します。 


I 書す I 

ENC RETURN ENC Set Record Time(UINT enc id , UINT rec time , UINT enabled ); 


引数 


enc id エンコーダの識別子 

rectime エンコードを行なう時間（単位:秒) 

enabled エンコードの 時間制限 


値 

説明 

TRUE 

時間制限有り 

FALSE 

時間制限なし 


戻り値 

成功 ENC_SUCCESS 

失敗 ENCFAIL 
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ENC_Get_Movie_File 


エンコードを行なうファイル《を巧得します。 


I 書对 

ENC_RETURN ENC_Get Movie_File(UINT encjd，UINT enc_mode_flag, 

LPTSTR enc_me); 


1 引数 1 

encid 

エンコーダの識別子 

enc mode flag 

エンコードを行なうファイルの種類 

enc file 

エンコードを行なうファイノレ名を取得するアドレス 

戻り値 

成功 

ENC_SUCCESS 

失敗 

ENC FAIL 


参照 

ENC_Set_Movie_File 
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ENC_Set_Movie_File 


エンコードを行なうファイル名を設定します。 


I 書对 

ENC_RETURN ENC_Set Movie_File(UINT encjd，UINT enc_mode_flag, 

LPCTSTR enc-file); 


引数 


encid エンコーダ の 識別子 

enc mode flag エンコードを巧なうファイルの種類 


値 

説明 

ENC RECORD AUDIO 

ホーデイホファイル 

ENC RECORD VIDEO 

ビデオ（エレメンタリストリーム）ファイル 

ENC_RECORD PS 

プログラムストリームファイルまたは 
システムストリームフアイノレ 


eiic_file エンコードを巧なうファイル名を設定するアドレス 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENC Get Frame Count 


エンコードを 行なった フレーム 数を取得します。 

I 書す I 

ENC RETURN ENC Get Frame Count(UINT enc id , UINT * frame count ); 


1 引数 1 

encid 

frame count 

エンコーダの 識別子 
フレーム 数を取得するアドレス 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 
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ENC Get Time 


エンコードを行なった時間を取得します。 

I 書す I 

ENC RETURN ENC Get Time(UINT enc id , double * time ); 


1 引数 1 

encid 

time 

エンコーダの識別子 

時間を取得するアドレス(単位:秒） 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 


canopus 


113 















MV 民 Series Development Kit 


ENCDetectVideoInpu し Source 


ビデオ入カソースを自動検出します。 


I 書す I 

ENC_RETURN ENC_Detect Videojnput Source(UINT encjd, LPINT IpfInputSource); 


引数 


enc id エンコーダの識別子 

Ip 打叩山 Source 検出されたビデオ入カソースの値を取得するアドレス 


値 

説明 

ENC VIDEO INPUT SOURCE COMPOSITE 

Composite 

ENC VIDEO INPUT SOURCE SVIDEO 

S-Video 


戻り値 

成功 ENC_SUCCESS 

失敗 ENCFAIL 


捕足 

• デジタル•ビデオ入力の場合は、戻り値として ENC_FAIL を返します。 ENC_Ge し Las し Error 
では、 MVR ERROR NO VIDEO SOURCE が返ります。 


参照 

ENCGetVideoParameter, ENCSetVideoParameter, ENCSetDigitalVideoInput, 
ENC Get Digital Video Input 
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ENCSetDigitalVideoInput 


アナログゼデオ入力とデジタル•ビデオ入力を切り換えます。 


I 書す I 

ENC RETURN ENC Set Digital Video InputfUINT enc id, BOOL fDigital); 


引数 


enc id エンコーダ の 識別子 

fDigital ビデオ入力を示す値 


値 

説明 

TRUE 

デジタル.ビデオ入力 

FALSE 

アナログ•ビデオ入力 


戻り値 


成功 

ENC_SUCCESS 

失敗 

ENC_FAIL 

補足 



参モニタ中にビデオ入力を変更する場合は、 ENC_Stop_Monitor によりモニタを停止させてから 
ENC_Se し Digita し Video_I 叩 ut により変更します。モニタを再開する場合は、この後に 

ENC Start Monitor を行ないます。 
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ENCGetDigitalVideoInput 


現在のビデオ入力の状態を取得します。 


I 書す I 

ENC_RETURN ENC_Get Digital Video_Input(UINT encjd, LPINT IpfDigital); 


引数 


enc id エンコーダ の 識別子 

IpfDigital ビデオ入力を示す値を取得する INT のポインタ 


値 

説明 

TRUE 

デジタル.ビデオ入力 

FALSE 

アナログ•ビデオ入力 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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ENC Set Video Encode File 


エンコード 開始時に詳細ビデオ •エンコード •パラメータを設をするための ファイル 《を指定します。 

I 書す I 

ENC_RETURN ENC_Set Video _ Encode _ File(UINT encjd , LPCTSTR IpszVEFile ); 


1引数1 

encid 

IpszVEFile 

エンコーダの識別子 

詳細ビデオ.エンコード•パラメータ用ファイル《のポインタ 

戻り値 
成功 
失敗 

ENC_SUCCESS 

ENC FAIL 


捕足 I 

IIpszVEFile に NULL を設定すると、詳細ビデオ•エンコード•パラメータの設定を行いません。 
ただし、一度エンコードを行った後で IpszVEFile に NULL を設定しても前回設定した値がそ 
のまま有効になります。設をを解除するには、 ENC_Terminate によりエンコーダを終了してく 
ださい。 

I 詳細ビデオ.エンコード•パラメータを設定するためのファイルの内容については、付属の 

VideoEncoderParams.txt をご覧ください。 
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ENC_Get IRE Setting 


NTSC セットアップレベル(黒レベル）の設定を取得します。 


I 書す I 

ENC RETURN ENC Get IRE 夕 etting(UINT enc id , LPINT IpnIreSetting ); 


引数 


enc id エンコーダの識別子 

IpnIreSetting セットアップレベルの情報を格納するための INT 変数へのポインタ 


値 

説明 

MVR IRE LEVEL 0 NTSC 

OIRE 

MVR IRE LEVEL 75 NTSC 

7.5 IRE 


戻り値 

成功 ENC_SUCCESS 

失敗 ENCFAIL 
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ENC_Set IRE Setting 


NTSC セットアップレベル ( 黒レベル）を設定します。 


I 書ぶ I 

ENC RETURN ENC Set IRE SettingfUINT enc id, INT nIreSetting); 


引数 


enc id エンコーダ の 識別子 

nlreSetting 設定する七ットアップレベル 


値 

説明 

MVR IRE LEVEL 0 NTSC 

OIRE 

MVR IRE LEVEL 75 NTSC 

7.5 IRE 


戻り値 

成功 ENC_SUCCESS 

失敗 ENCFAIL 


補足 

• 日本では 0 IRE が標準です。 

• ビデオ入力部の七ットアップレベルを変更した場合 ENC_Set_Video_Parameter で設定される 
ビデオ入カパラメータ（明るさ、コントラスト、色合い、色の濃さ）は対応するデフオルト値に変更 
されます。 
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ENC Get Last Error 


最新のエラー情報を取得します。 

ULONG ENC_Get Last Error(UINT encjd); 


1引数1 

encid 

エンコーダの識別子 

戻り値 

ULONG 

エラーコード (APPENDIX1. エラーコード表参照） 

補足 



ENC_Ge し Las し Error を実行すると、エラー情報はクリアされます。エラーが発生していない 
場合や新たにエラーが発生するまでは、 MVR ERROR SUCCESS が返されます。 


canopus 


120 

















MV 民 Series Development Kit 



コールバック関数の設定を行ないます。 


書式 


DEC-RETURN DEC_Set Callback(UINT decjd, DEC_CB STATUS status, 

DEC_CB ERROR error); 


I 引数 I 

decjd デコーダの 識別子 

status 内部が態通知用コールバック関数を設定する 

error エラー通知用コールバック関数を設定する 

DEC_CB STATUS コールバック関数の定義 

デコーダの 内部状態を取得するための コールバック 関数 

VOID CALLBACK StatusProc(UINT decjd, DEC_STATUS_NOTIFY status); 
decjd デコーダの 識別子 

status 内部状態 


値 

説明 

DEC NOTIFY INITIALIZE 

デコーダの初期化が行われた 

DEC NOTIFY TERMINATE 

デコーダが終了した 

DEC NOTIFY STOP 

デコードが停止した 

DEC NOTIFY PAUSE 

デコードを一時停止した 

DEC NOTIFY PLAY 

デコードを開始した 


DEC_CB ERROR コールバック関数の定義 

デコード中にエラーが発生した場合に、そのエラー情報を取得するためのコールバック関数 

VOID CALLBACK ErrorProc(UINT decjd, ULONG error); 
decjd デコーダの 識別子 

error エラーコード (APPENDIX1. エラーコード表参照） 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 
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I 補足 I 

• DEC CB ERROR で定義した コールバック 関数は、 エンコード 中に エラーが 発生した場合に 
実行されます。関数を実行して DEC _ FAIL が戻り値をして返された場合は、 
DEC_Get Last Error により エラー 情報を取得してください。 


参照 

DEC Get Last Error 


canopus 


122 









MV 民 Series Development Kit 


DECCanlnitialize 


デコーダを 初期化できるか調べます。 


I 書す I 

ENC_RETURN DEC _ Can _ Initialize(UINT encjd ); 


I 引数 I 

decjd デコーダの 識別子 


戻り値 

デコーダの初期化が可能な場合 DEC_SUCCESS 

すでに使用しているかデコーダを初期化できない場合 DEC FAIL 
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DECGetCodecConfig 


カードに関する情報を取得します。 


I 書す I 

DEC-RETURN DEC_Ge し Codec—Config (UINT decjd, DEC_CONFIG *pConfig); 


I 引数 I 

decjd デコーダの 識別子 

pConfig 情報を取得する DEC_CONFIG 構造体へのポインタ 

DEC_CONFIG 構造体のを義 

カードに関する情報を取得する。 

typedei struct { 

UINT NumberCodecs; 

UINT CodecNumber; 

UINT CodecCaps; 

UINT CurrentUtilization; 

} DEC_CONFIG; 


NumberCodecs 装着されてレ、るカード枚数が格納される。 

CodecNumber 情報を取得した V 、カード番号 (1 〜 NumberCodecs) を指定する。 

CodecCaps CodecNumber で指をしたカードに関する詳細情報フラグが格納される。 


値 

意巧 

DECCAP NONE 

情報がないことを示すフラグ 

DECCAP ENCODE 

エンコードが 可能であることを示すフラグ 

DECCAP DECODE 

デコードが 可能であることを示すフラグ 

DECCAP MONITOR 

モニタが可能であることを示すフラグ 

DECCAP AVI2MPEG 

AVI ファイルを MPEG に変换可能であることを示 
すフラグ 

DECCAP D 2200 

MVR-D2200 であることを示すフラグ 

DECCAP D 220 OV 

MVR-D2200V でをることを示すフラグ 


CurrentUtilization CodecNumber で指定したカードが使用状況が格納される。 


値 

意み 

TRUE 

使用している 

FALSE 

使用していない 


戻り値 

成功 DEC_SUCCESS 
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失敗 DEC_FAIL 

[~補足"！ 

• DEC _ CONFIG 構造体の CodecNumber に 0 を指定すると、装着されてレ、るカード枚数と現在 
使用しているカード番号を取得できます。カード枚数は NumberCodecs に格納されます。カー 
ド番号は CodecNumber に格納されます。カードが使用されていない場合は CodecNumber 
に0が格納されます。 
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DEC Set Codec Number 


使用するカード番号を設定します。 

DEC-RETURN DEC_Set Codec_Number(UINT decjd, UINT nNumber); 


1 引数 1 

decid 

nNumber 

デコーダの 識別子 
使用するカード番号 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

1補足1 



参 DECJnitialize または DEC_Initialize_Ex による初期化を行う前に DEC_Se し Codec_Number 

を実行してください。初期化を行う前に DEC_Set Codec_Number を実行しない場合は、自動 
的に使用可能なカードを探して初期化を行います。 

参指定できるカード番号は、 1 から DEC_Get_Codec_Config で取得した DEC_CONFIG 構造体 
の NumberCodecs までの値です。 

参カード番号に0を指定した場合は、初期化時に自動的に使用可能なカードを探します。 

参照 

DEC Get Codec Config, DEC Initialize, DEC Initialize Ex 


canopus 


126 





















MV 民 Series Development Kit 


DEC Initialize 


デコーダの 初期化を行な レ 、ます。 

DEC RETURN DEC Initialize(UINT dec id); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DEC Initialize Ex 


デコーダの 初期化を行なう。 


I 書对 

DEC-RETURN DEC_Initialize_Ex(UINT decjd，DEC_MEDIA media, 

DEC_BSR_PARAMETER* pParam); 


引数 


decjd デコーダの 識別子 

media デコー ドの 種類 


値 

意み 

DEC-MEDIA FILE 

ファイル 

DEC-MEDIA MEMORY 

メモリ転送 


pParam メモリ転送用パラメータを設定する DEC_BSR_PARAMETER 構造体のポインタ 

pParam は、 media が DEC_MEDIA MEMORY の場合に設定する。 

それが外の場合は、 NULL を指定する。 

DEC_BSR_PARAMETER 構造体の定義 

メモリ転送用パラメータ情報を設定する。 

typedei struct { 

DEC_BSR_TYPE 
DEC_CB BSR 
DWORD 
DWORD 
DWORD 

} DEC_BSR_PARAMETER; 


fType MPEG データの種類を設定する 


値 

意味 

DEC BSR TYPE UNKOWN 

なし 

DEC_BSR_TYPE PS 

MPEG2 プログラムストリーム 

MPEGl システムストリーム 

DEC BSR TYPE AUDIO 

MPEG オーデイオエレメンタリストリーム 

DEC BSR TYPE VIDEO 

MPEG ビデオエレメンタリストリーム 


fType; 

pfnCallback; 

cbBuff; 

cBuff; 

dwData; 
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pfnCallback 

cbBuff 

cBuff 

dwData 


メモリ 転送用 コールバック 関数を設定する 
コールバック 時に メモリ 転送する バッファ サイズ 
サイズは、 1024 byte の倍数を指定する。 
CbBuff で指定した バッファの 数 
コールバック 時に送られる 32bit データ 


DEC_CB BSR コールバック関数の定義 

デコードデータを 転送するた めのコールバック 関数 


VOID CALLBACK BsrProc(LPBYTE pbBuff, DWORD cbWrite, 


pbBuff 

cbWrite 

pcbWritten 

dwData 


LPDWORD pcbWritten, DWORD dwData); 

デコードデータを 格納す るバッファの ポインタ 
デコードデータを 格納す る サイズ 

格納されたデコードデータのサイズを設定するバッファのポインタ 
DEC_BSR_PARAMETER 構造体で設定された dwData の値 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 
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DEC Terminate 


デコーダを 終了します。 

DEC-RETURN DEC _ Terminate(UINT decjd ); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


I 補足 I 

参 DEC _ Termmate 実行後、 DEC_Se し Ca 此 ack によるコールバックの設定は全て解除されます。 
参照 

DEC Set Callback 
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DEC Get Media 


デコードの種類を取得します。 

I 書す I 

DEC RETURN DEC Get MediafUINT dec id, DEC MEDIA* media); 


1 引数 1 

decid 

media 

デコーダの識別子 

デコードの種類を取得する DEC MEDIA へのポインタ 

戻り 値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 

DEC Initialize Ex 
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DEC Set Media 


デコードの種類を設定します。 

I 書す I 

DEC RETURN DEC Set Media(UINT dec id, DEC MEDIA media); 


1 引数 1 

decid 

media 

デコーダの識別子 
デコードの種類 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 

DEC Initialize Ex 
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DECCanPlayback 


再生が可能か判断します。 

DEC-RETURN DEC _ Can _ Playback(UINT decjd ); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
再生可能 
再生不可能 

DEC-SUCCESS 

DEC FAIL 
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DECGetStatus 


デコーダの 内部状態を取得します。 


I 書す I 

DEC-RETURN DEC_Get Status(UINT decjd, DEC_STATUS* status); 


引数 


decjd デコーダの 識別子 

status デコーダの内部状態を取得する DEC STATUS へのポインタ 


値 

意ホ 

DEC-STATUS-WAITINITIALIZE 

初期化待ち状態 

DEC STATUS WAITTERMINATE 

終了待ち状態 

DEC STATUS STOP 

停止中 

DEC STATUS PAUSE 

一時停止中 

DEC STATUS PLAY 

デコード中 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 
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DECCanOverlayWindow 


オーバーレイウィンドウを使用できるかどうか判断します。 


I 書す I 

DEC-RETURN DEC_Caii Overlay Window(UINT decjd, HANDLE hMonitor, 

UINT nWidth, UINT nHeight); 


I 引数 I 

decjd デコーダの識別子 

hMonitor モニタハンドル 

nWidth オーノくーレイウインドウの幅 

nHeight オーバーレイウインドウの高さ 


戻り値 

オーバーレイウインドウが使用できる場合 DEC_SUCCESS 

オーバーレイウィンドウが使用できない場合 dec_fail 


I 補足 I 

• hMonitor には、マルチモニタでのプライマリまたは七カンダリのモニタハンドルを設定します。 
マルチモニタでない場合は、 hMonitor に NULL を設定します。 
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DECCreateOverlayWindow 


オーバーレイウィンドウを生成します。 

I 書す I 

DEC-RETURN DEC _ Create_Overlay Wmdow(UINT decjd , HWND hWndParent , HWND * 
hWndOverlay , int x , int y , UINT nWidth , UINT nHeight ); 


1 引数 1 

decid 

hWndParent 

hWndOverlay 

X 

デコーダの識別子 

オーバーレイウインドウを生成するウインドウのハンドル 
オーバーレイウインドウのハンドルを取得するアドレス 
オーノく ■ —レイウインドウの位置(左） 

y 

nWidth 

nHeight 

オーノくー レイウインドウの位置（上） 

オーバーレイウインドウの幅（最大720) 

オーバーレイウインドウの高さ（最大 NTSC 480 、 PAL 576) 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

陆足 1 



• オーバーレイウィンドウ生成時は、サイズが制限されますが、生成後は 
DEC _ Resize _ Overlay_Window 行により制限な上のサイズを指定できます。 

• デコード中は生成できません。 

• MVR - D 2200 V を使用している場合はオーバーレイウィンドウが作成できない場合、 GDI で描 
画をおこなうためのウィンドが作成されます。 

参照 

DEC Resize Overlay Window 
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DECCanVideoPortOverlayWindow 


ビデオポートを利用したオーバーレイウィンドウを使用できるかどうか半り断する。 


I 書す I 

DEC-RETURN DEC_Caii VideoPort Overlay Wmdow(UINT decjd, HANDLE hMonitor, 

UINT nWidth, UINT nHeight); 


I 引数 I 

decjd デコーダの識別子 

hMonitor モニタ ハンドル 

nWidth オーノくーレイウインドウの幅 

nHeight オーバーレイウインドウの高さ 


戻り値 

オーバーレイウインドウが使用できる場合 DEC_SUCCESS 

オーバーレイウィンドウが使用できない場合 dec_fail 


I 補足 I 

• hMonitor には、マルチモニタでのプライマリまたは七カンダリのモニタハンドルを設定します。 
マルチモニタでない場合は、 hMonitor に NULL を設定します。 
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DECCreateVideoPortOverlayWindow 


ビデオポートを利用したオーノくー レイウィンドウを生成する。 

I 書す I 

DEC-RETURN DEC _ Create_Overlay Wmdow(UINT decjd , HWND hWndParent , HWND * 
hWndOverlay , int x , int y , UINT nWidth , UINT nHeight ); 


1引数1 

decid 

hWndParent 

hWndOverlay 

X 

デコーダの識別子 

オーバーレイウインドウを生成するウインドウのハンドル 
オーバーレイウインドウのハンドルを取得するアドレス 
オーノく ■ —レイウインドウの位置(左） 

y 

nWidth 

nHeight 

オーノくー レイウインドウの位置（上） 

オーバーレイウインドウの幅（最大720) 

オーバーレイウインドウの高さ（最大 NTSC 480 、 PAL 576) 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

陆足1 



• オーバーレイウィンドウ生成時は、サイズが制限されますが、生成後は 
DEC _ Resize _ Overlay_Window 行により制限な上のサイズを指定できます。 

• デコード中は生成できません。 

• 生成した後は通常のオーバーレイウィンドウと同様に使用できます。 

• MPL - D 2000 でしか使用できません。 

参照 

DEC Resize Overlay Window 
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DECDestroyOverlayWindow 


オーバーレイウィンドウを破棄します。 

DEC RETURN DEC Destroy Overlay Window(UINT dec id ); 


1引数1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


I 補足 I 

♦デコード中は破棄できません。 


canopus 


139 

















MV 民 Series Development Kit 


DEC Move Overlay Window 


オーノくー レイウィンドウを移動します。 

DEC RETURN DEC Move Overlay _ Wmdow(UINT dec id ， INTx ， INTy ); 


1 引数 1 

decid 

X 

デコーダの識別子 

オーバーレイウインドウの左上隅のスクリーン X 座標 

y 

オーバーレイウインドウの左上隅のスクリーン y 座標 

戻り 値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DECResizeOverlayWindow 


オーバーレイウィンドウのサイズを変更します。 

I 書す I 

DEC RETURN DEC Resize Overlay Window(UINT dec id, UINT nWidth, UINT nHeight); 


1 引数 1 

decid 

nWidth 

nHeight 

デコーダの識別子 
オーバーレイウインドウの 幅 
オーバーレイウインドウの高さ 

戻り 値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DECShowOverlayWindow 


オーバーレイウィンドウの表示状態を切り換えます。 


I 書す I 

DEC-RETURN DEC _ Show_Overlay Window(UINT decjd , BOOL 松 how ); 


引数 


decjd デコーダの 識別子 

仪 how ォ'—ノく'—レイウィンドウの表示/非表示 


値 

説明 

TRUE 

表示 

FALSE 

非表示 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 
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DECGetOverlayWindow 


オーバーレイウインドウのハンドルを取得します。 

I 書す I 

DEC RETURN DEC Get Overlay Window(UINT dec id, HWND* pWnd); 


1 引数 1 

decid 

pWnd 

デコーダの識別子 

オーバーレイウインドウのハンドルを取得するアドレス 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DECGetOverlayRect 


オーノくーレイウインドウの表不領域を取得します。 

I 書す I 

DEC RETURN DEC Get Overlay Rect(UINT dec id, LPRECT pRect); 


1 引数 1 

decid 

pRect 

デコーダの識別子 

オーバーレイウィンドウの表示領域を取得する RECT 構造体へのポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


補足 I 

I MV 民 - D 220 OV では使用できません。 
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DECSetOverlayRect 


オーノくーレイウインドウの表不領域を設定します。 


I 書す I 

DEC RETURN DEC Set Overlay Rect(UINT dec id, LPRECT pRect); 


I 引数 I 

decjd デコーダの 識別子 

pRect オーバーレイウィンドウの表示領域を設定した RECT 構造体へのポインタ 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 


I 捕足 I 

• pRect で設定可能な範囲は次のとおりです。 


ビデホフオーマット 

水平位置 

垂直位置 

NTSC 

〇 〜720 

〇 〜480 

PAL 

〇 〜720 

〇 〜576 


参再生時の画像サイズにより次の水平/垂直お大率をかけて計算した値を設定します。 


ビデホフオーマット 

水平お大率 

垂直化大率 

NTSC SIF な下 

X2 

X2 

NTSC Half-Dl な下 

X2 

XI 

NTSC 上記が外 

XI 

XI 

PAL SIF な下 

X2 

X2 

PAL Half-Dl が下 

X2 

XI 

PAL 上記が外 

XI 

XI 


• デコード中は設定できません。 

• MV 民 - D 2200 V では使用できません。 


canopus 


145 





































MV 民 Series Development Kit 


DECStar し Monitor 


モニタを開始します。 


I 書す I 

DEC-RETURN DEC_Star し Momtor(UINT decjd); 


I 引数 I 

decjd デコーダの 識別子 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 


I 補足 I 

参 DEC_Start Monitor を実行すると、オーバーレイウィンドウは生成時のサイズに戻ります。 
参デコード中は開始できません。 
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DECStopMonitor 


モニタを停止します。 

DEC_RETURN DEC _ Stop _ Monitor(UINT decjd); 


1引数1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

補足 



デコード中は停止できません。 
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DECGetMonitorStatus 


モニタの状態を取得します。 


I 書す I 

DEC-RETURN DEC_Get Monitor Status(UINT decjd , UINT * monitor ); 


引数 


decjd デコーダの 識別子 

monitor モニタのが態を取得するアドレス 


値 

説明 

TRUE 

モニタ中である 

FALSE 

モニタ中でない 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 
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DEC Get BSR Parameter 


メモリ転送用パラメータを巧得します。 

DEC-RETURN DEC_Ge し BSR _ Parameter(UINT decjd , 



DEC _ BSR _ PARAMETER * pParam ); 

1 引数 1 

decid 

pParam 

デコーダの 識別子 

メモリ転送用パラメータを取得する DEC _ BSR _ PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 

DEC Initialize Ex 
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DEC Set BSR Parameter 


メモリ転送用パラメータを設定します。 

DEC-RETURN DEC_Set BSR _ Parameter(UINT decjd , 



DEC _ BSR _ PARAMETER * pParam ); 

1 引数 1 

decid 

pParam 

デコーダの 識別子 

メモリ転送用パラメータを鼓をする DEC _ BSR _ PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 

DEC Initialize Ex 
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DECGetOverlayParameter 


オーバーレイ 表示 パラメータを 取得します。 


I 書对 

DEC-RETURN DEC_Get Overlay Parameter(UINT decjd， 

DEC_OVERLAY PARAMETER* pParam); 


I 引数 I 

decjd デコーダの 識別子 

pParam ホーバー レイ表示パラメータを取得する 

DEC_OVERLAY PARAMETER 構造体のポインタ 


DEC_OVERLAY PARAMETER 構造体の定義 

オーバーレイ 表示 パラメータ 情報が格納される。 

typedei struct { 


UINT 

nOverlay け rightness; 

int 

nOverlayContrast; 

int 

nOverlaySaturation; 


} DEC OVERLAY PARAMETER; 


nOverlayBrightness 巧るさの値が格納される。 


値 

説明 

DECMIN VIDEO OVERLAY BRIGHTNESS 

最小値 

DECMAX VIDEO OVERLAY BRIGHTNESS 

最大値 

DECDEF VIDEO OVERLAY BRIGHTNESS 

デフォルト値 


nOverlayContrast コントラストの値が格納される。 


値 

説明 

DECMIN VIDEO OVERLAY CONTRAST 

最小値 

DECMAX VIDEO OVERLAY CONTRAST 

最大値 

DECDEF VIDEO OVERLAY CONTRAST 

デフォルト値 

nOverlaySaturation 色の濃さの値が格納を 

化。 

値 

説明 

DECMIN VIDEO OVERLAY SATURATION 

最小値 

DECMAX VIDEO OVERLAY SATURATION 

最大値 

DECDEF VIDEO OVERLAY SATURATION 

デフォルト値 
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戻り値 

成功 DEC_SUCCESS 

失敗 DEC_FAIL 
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DECSetOverlayParameter 


オーバーレイ表示パラメータを設定します。 

DEC RETURN DEC Set Overlay Parameter(UINT dec id, 



DEC_OVERLAY PARAMETER* pParam); 

1 引数 1 

decid 

pParam 

デコーダの識別子 

才 ' ーノス ' ーレイ表示パラメ'ータを設をする 

DEC_OVERLAY PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 




参照 

DECGetOverlayParameter 
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DEC Get Video Parameter 


ビデオパラメータを取得します。 


I 書す I 

DEC-RETURN DEC_Get Video_Parameter(UINT decjd, 

DEC_VIDEO PARAMETER* Video_Param); 


I 引数 I 

decjd デコーダの 識別子 

Video_Param ビデオパラメータを取得する DEC_VIDEO PARAMETER 構造体のポインタ 


DEC_VIDEO PARAMETER 構造体の定義 
ビデオパラメータ情報が格納される。 

typedei struct { 

int TVSystem; 

} DEC VIDEO PARAMETER; 


TV System 放送規格の種類が格納される。 


値 

説明 

DEC VIDEO TV SYSTEM NTSC 

NTSC 

DEC VIDEO TV SYSTEM PAL 

PAL 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 


canopus 


154 






















MV 民 Series Development Kit 


DEC Set Video Parameter 


ビデオパラメータを設定します。 

DEC-RETURN DEC_Set Video_Parameter(UINT decjd, 



DEC-VIDEO PARAMETER* Video_Param); 

1 引数 1 

decid 

VideoParam 

デコーダの識別子 

ビデオパラメータを設定する DEC_VIDEO PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


I 補足 I 

• モニタ中に DEC_VIDEO PARAMETER 構造体の TV_System の値を変更する場合は、 
DEC_Stop_Monitor によりモニタを停止させてから DEC_Set_Video_Parameter により値を変 

更します。モニタを再開する場合は、この後に DEC_Start Monitor を行ないます。 

参照 

DEC Get Video Parameter, DEC Start Monitor, DEC StoD Monitor 
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DEC Get Audio Parameter 


オーディオパラメータを取得します。 


I 書对 

DEC_RETURN DEC_Get_Audio_Parameter(UINT decjd, 

DEC-AUDIO PARAMETER* Audio_Param); 


I 引数 I 

decjd デコーダの 識別子 

Audio_Param ホーデイホパラメータを取得する DEC_AUDIO PARAMETER 構造体のポインタ 

DEC_AUDIO PARAMETER 構造体の定義 

オーディオパラメータ情報が格納される。 

typedei struct { 

BOOL fOutputMute; 

DWORD dwLeftOutputAtt; 

DWORD dwRightOutputAtt; 

} DEC-AUDIO PARAMETER; 


fOutputMute ミュートが態が格納される。 


値 

説明 

TRUE 

ミュート ON 

FALSE 

ミュート OFF 


dwLeftOutputAtt 左の音量が格納さ ; 

1 る。 

値 

説明 

DECMIN AUDIO OUTPUT ATT 

最小値 

DECMAX AUDIO OUTPUT ATT 

最大値 


dwRightOutputAtt 右の音量が格納される。（値は dwLeftOutputAtt と同じ ) 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 
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DEC Set Audio Parameter 


オーディオパラメータを設定します。 

DEC-RETURN DEC_Set Audio_Parameter(UINT decjd ， 



DEC-AUDIO PARAMETER* Audio_Param); 

1 引数 1 

decid 

AudioParam 

デコーダの識別子 

オーディオパラメータを設定する DEC_AUDIO PARAMETER 構造体のポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 



DEC Get Audio Parameter 
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DEC Get Decode Parameter 


デコーい巧メータを 取得します。 


I 書す I 

DEC_RETURN DEC_Get Decode_Parameter(UINT decjd, 

DEC DECODE PARAMETER* Decode Param); 


I 引数 I 

decjd デコーダの 識別子 

Decode_Param デコード パラメータを取得する DEC_DECODE PARAMETER 構造体のポインタ 

DEC_DECODE PARAMETER 構造体の定義 
デコーい巧メータ 情報が格納され る。 

typedei struct { 

BOOL fTimestampUsage; 

BOOL fRepeatOnStop; 

BOOL fFrameRepeat; 

BOOL fPanScan; 

BOOL fFrameClip; 

} DEC_DECODE PARAMETER; 

fTimestampUsage MPEGl システムストリーム / MPEG2 プログラムストリームの再生時、ビットストリー 


ム内のタイムスタンプ (PTS/DTS) を用いるか否かの値が格納される。 


値 

説明 

TRUE 

タイムスタンプを用いる 

FALSE 

タイムスタンプを用いない 


fRepeatOnStop デコード終了時、最終フレームを表示する力巧う => の値が格納される。 


値 

説明 

TRUE 

表示する 

FALSE 

表示しない 


fFrameRepeat デコード終了時、最終フレームを表示する場合の表示ホ法が格納される。 


値 

説明 

TRUE 

フレーム表示 

FALSE 

フイ^ールド表示 
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fPanScan アスペクト比 16:9 の画像で、表示領域サイズの情報がある場合に表示領域の部 


分を化大し、アスぺ外比 16:9 でま示するかの可否が格納される。 


値 

説明 

TRUE 

化大表示する 

FALSE 

拡大表示しない 


fFrameClip 再生時、表示フレームの端の部分を表示しないようにするかの可否が格納され 


る。 


値 

説明 

TRUE 

表示フレームの端の部分を表示しない 

FALSE 

表示フレ^ームの端の部分を表示する 


戻り値 


成功 

DEC-SUCCESS 

失敗 

DEC-FAIL 

捕足 



• DEC_DECODE PARAMETER 構造体については、今後必要に応じてパラメータがお張さ 
れる場合があります。 
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DEC Set Decode Parameter 


デコードパラメータを設定します。 


I 書对 

DEC-RETURN DEC_Set Decode_Parameter(UINT decjd ， 

DEC_DECODE PARAMETER* Decode_Param); 


引数1 



dec id 


デコーダの識別子 

Decode Param 

デコードパラメータを設定する DEC_DECODE PARAMETER 構造体のポインタ 

戻り値 




成功 DEC_SUCCESS 

失敗 DEC_FAIL 


I 補足 I 

• DEC_DECODE PARAMETER 構造体の fPanScan のに TRUE を設定すると、表示領域サ 

イズの情報が画像データに含まれて いる 場合、表示領域の部分を拡大し、アスペクト比16:9で 
表示しま于。 

例えば、画像サイズ720 X 480、表示領域サイズ 540 X 480 の場合は下図のように表示されま 
す。 


720 


◄ — 

イ 

540 


— ► 







表示領域 




◄- 


J 720 




表示領域 
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• DEC_DECODE PARAMETER 構造体の fPanScan のに TRUE を設定した場合、水平/垂 
直化大率は次のようになります。 


ビデ オフ ホー マット 

水平お大率 

垂直お大率 

NTSC SIF な下 

X8/3 

X2 

NTSC Half-Dl な下 

X8/3 

XI 

NTSC 上記な外 

X4/3 

XI 

PAL SIF が下 

X8/3 

X2 

PAL Half-Dl な下 

X8/3 

XI 

PAL 上記な外 

X4/3 

XI 


• fPanScan のに FALSE を設定した場合、または、表示領域サイズの情報ボ画像データに含ま 
れていない場合、次の水平/垂直お大率になります。 


ビデオフ ホー マット 

水平お大率 

垂直拡大率 

NTSC SIF な下 

X2 

X2 

NTSC Half-Dl な下 

X2 

XI 

NTSC 上記が外 

XI 

XI 

PAL SIF が下 

X2 

X2 

PAL Half-Dl な下 

X2 

XI 

PAL 上記な外 

XI 

XI 


♦MPEG1 については、 fPanScan は無視されます。 

• DEC_DECODE PARAMETER 構造体の次のメンバは MVR - D 2200 V では設定できません。 

fTimestampUsage (常時 TRUE) 、 fFrameRepeat (常時 TRUE)、fPanScan (常時 FALSE )、 
fFrameClip (常時 FALSE) 


参照 

DEC Get Decode Parameter 


canopus 


161 































MV 民 Series Development Kit 


DEC_Play 


デコードを開始します。 

DEC-RETURN DEC_Play(UINT decjd); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


I 捕足 I 

• デコードは、 DEC_Seek で指定した位置から開始します。 
参照 

DEC Seek 
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DECPlayFrom 


指定した位置からデコードを開始します。 

DEC-RETURN DEC_Play From(UINT decjd , DWORD dwPosition); 


1 引数 1 

decid 

dwPosition 

デコーダの 識別子 
再生開始位置 ( 単位 : ミリ秒） 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 

DEC Seek 
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DEC Pause 


デコードを一時停止します。 

DEC-RETURN DEC_Pause (UINT decjd); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DEC Resume 


デコードを再閉します。 

DEC_RETURN DEC_Resume (UINT decjd); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DEC_Stop 


デコードを停止します。 

DEC-RETURN DEC_Stop (UINT decjd); 


1 引数 1 

decid 

デコーダの 識別子 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DECGetBitmapBits 


静止画 (BMP) をバッファで取得します。 

I 書す I 

DEC-RETURN DEC_Get BitmapBits(UINT decjd, LPBYTE* IpByte, LPDWORD pdwLen, 
MVRSTILLCAPPARAM pParam); 


1 引数 1 

decid 

IpByte 

pdwLen 

pParam 

デコーダの識別子 

データを格納するバッファへのポインタを格納するポインタ 
取得した静止画のバイト数を格納するポインタ 

静止画キャプチャパラメータを設定する MVRSTILLCAPPARAM 構造体 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


I 捕足 I 

• キヤプチヤ時に映像の DMA の転送を 1 度止めるので PC 上のオーバーレイの映像が一瞬停 
止します。（外部モニタへ出力されてレ、る映像は停止しません） 

参取得できる静止画のサイズはソースの画像サイズになります。 

• 画像の縦のサイズが 480 な下の場合 MVRSTILLCAPPARAM 構造体の nFrameCap の値 
は何を指定しても MV 民 STILL FRAME になります。 
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DEC Save DIB 


静止画 ( BMP ) をファイルに保存します。 

I 書す I 

DEC-RETURN DEC_Save_DIB(UINT decjd ， LPCTSTR IpszFileName, 
MVRSTILLCAPPARAM pParam); 


1引数1 

decid 

IpszFileName 

pParam 

デコーダの 識別子 
保存するファイルぶ 

静止画キャプチャパラメータを設定する MVRSTILLCAPPARAM 構造体 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 




参照 

DEC _ Ge し BitmapBits の補足を確認してください。 
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DEC Save JPEG 


静止画 ( JPEG ) をファイルに保存します。 

I 書す I 

DEC-RETURN DEC_Save_JPEG(UINT decjd，LPCTSTR IpszFileName, UINT nQuality, 
MVRSTILLCAPPARAM pParam); 


1 引数 1 

decid 

IpszFileName 

nQuality 

デコーダの 識別子 
保存するファイルぶ 

JPEG の圧縮率 (0 〜 9 の範囲で指定できます ) を指定します。 

0 : 狗 1/5 

1: 約 1/7 

2 : 約 1/10 

3 : 約 1/12 

4 : 約 1/15 

5 : 約 1/17 

6 : ^ 1/20 

7 : ^ 1/25 

8 : 狗 1/30 

9 : 狗 1/40 

pParam 

静止画キャプチャパラメータを設定する MVRSTILLCAPPARAM 構造体 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 




参照 

DEC_Ge し BitmapBits の補足を確認してください 
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DECGetRepeat 


リピート状態を取得します。 

DEC-RETURN DEC_Get Repeat(UINT decjd, UINT* repeat); 


1 引数 1 

decid 

repeat 

デコーダの 識別子 

リピート状態を取得するアドレス 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

参照 

DEC Set Repeat 
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DECSetRepeat 


リピート状態を設定します。 


I 書す I 

DEC-RETURN DEC_Set Repeat(UINT decjd, UINT repeat); 


引数 


decjd デコーダの 識別子 

repeat リピート状態を設定する 


値 

説明 

TRUE 

リピート ON 

FALSE 

化。ート OFF 


戻り値 


成功 

DEC-SUCCESS 

失敗 

DEC-FAIL 

補足 



• リピートの設定が有効になるのは、ファイルによるデコードの場合です。 

• メモリ転送によるデコードの場合、リピートの設定を行なうことはできますが、実際にはリピートさ 
れません。 


参照 

DEC Initialize Ex, DEC Get Media 
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DEC Get Movie File 


デコードを行なうファイルぶを取得します。 

I 書す I 

DEC RETURN DEC Get Movie FilefUINT dec id, LPTSTR dec file); 


1 引数 1 

decid 

decfile 

デコーダの識別子 

デコードを行なうファイルぶを取得するアドレス 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DEC Set Movie File 


デコードを行なうファイルぶを設定します。 

I 書す I 

DEC-RETURN DEC_Set Movie_File(UINT decjd, LPCTSTR dec—file); 


1 引数 1 

decid 

decfile 

デコーダの識別子 

デコードを行なうファイノレぶを設定するアドレス 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 


I 捕足 I 

• メモリ転送の場合は、設定できません。 

• DEC_Set_Movie_File を実行後、デコード開始位置は先頭になります。 
参照 

DEC Initialize Ex 


canopus 


173 





















MV 民 Series Development Kit 


DECGetImageSize 


デコードを行なうファイルの画像サイズを取得します。 

I 書す I 

DEC RETURN DEC Get Image Size(UINT dec id, 



HINT* image width, UINT* image height); 

1 引数 1 

decid 
image width 
image height 

デコーダの 識別子 

画像サイズ ( 幅）を取得するアドレス 

画像サイズ楠さ）を取得するアドレス 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 
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DEC Get Frame Count 


デコードを行なったフレーム数を取得します。 

I 書す I 

DEC-RETURN DEC_Get Frame_Count(UINT decjd, UINT* frame—count); 


1 引数 1 

decid 

irame count 

デコーダの 識別子 
フ レ ' ー ム数を取得するアドレス 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

1 補足 1 



参オーバーレイ表示 中に オーバーレイウインドウの 位置 . サイズを 変更す ると、フレーム 数が カウン 
卜されなくなります。 
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DEC Get Time 


デコードを行なった時間を取得します。 

I 書す I 

DEC RETURN DEC Get Time(UINT dec id, double* time); 


1引数1 

decid 

time 

デコーダの識別子 

時間を取得するアドレス(単位:秒） 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


補足 I 

I メモリ転送によるデコードの時は、オーノくーレイ表示中にオーノくーレイウインドウの位置•サイズ 
を変更ずると、時間が更新されなくなります。 
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DEC_Get Type 


デコードの種類を取得します。 


I 書す I 

DEC-RETURN DEC_Get Type(UINT decjd, DEC_TYPE* type); 


引数 


decjd デコーダの 識別子 

type デコードの種類を取得する DEC TYPE のポインタ 


値 

説明 

DEC-TYPE UNKNOWN 

不明 

DEC-TYPE MPEG し AUDIO 

MPEGl オーディオ 

DEC-TYPE MPEG し VIDEO 

MPEGl ビデオ 

DEC-TYPE MPEG し SYSTEM STREAM 

MPEGl システムストリーム 

DEC-TYPE MPEG2 AUDIO 

MPEG2 オーディオ 

DEC-TYPE MPEG2 VIDEO 

MPEG2 ビデオ 

DEC-TYPE MPEG2 PROGRAM STREAM 

MPEG2 プログラムストリーム 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 
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DEC_Get_File Tvpe 


ファイルの種類を取得します。 


I 書す I 

DEC-RETURN DEC_Get File_Type(UINT decjd, LPCTSTR dec_file, DEC_TYPE* type); 


I 引数 I 

decid 

decfile 

type 


デコーダの 識別子 
ファイル《のアドレス 

デコードの種類を取得する DEC_TYPE のポインタ 


戻り値 

成功 DEC_SUCCESS 

失敗 DEC FAIL 


参照 

DEC Get Type 
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DECGetPlaybackTime 


再生時間を取得します。 

I 書す I 

DEC-RETURN DEC_Get Playback Time(UINT decjd, LPDWORD IpdwTime); 


1 引数 1 

decid 

デコーダの 識別子 


IpdwTime 再生時間を取得するためのバッファへのポインタ（単位 : ミリ秒 ) 


戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC-FAIL 

1 補足 1 



• DEC_Set Movie_File で指定したファイルについての再生時間を取得します。 

• DEC_Seek により再生位置の指定が可能なファイルついて再生時間を取得することができま 
す。 

参照 

DEC Set Movie File, DEC Seek 
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DEC Seek 


再生を開始する位置を指定します。 


I 書す I 

DEC-RETURN DEC_Seek(UINT decjd, DWORD dwPosition); 


引数1 



dec id 


デコーダの 識別子 

dwPosition 

再生開始位置(単位:ミリ秒) 

戻り値 



成功 


DEC-SUCCESS 

失敗 


DEC-FAIL 

捕足 




• 再生位置の指定に関しては、次の制限事項があります。 

① プログラム.ストリーム/ビデオ.エレメンタリ.ストリームについては、ビデオ.エレメンタリ. 
ストリーム 内の GOP 内の タイム •コードを利用する。よって、次に当てはまる ファイルに 関 
しては再生位置を指定できない。 

• GOP がない 

. タイム•コードが設定されていない 

- 再生時間が24時間より大きい（タイム•コードは24時間までしか格納できないため） 

② GOP の時間間隔(通常 0.4 〜 1.0 秒)より小さい時間間隔の位置への移動はできない。 

③ Video CD ファイル (RIFF CDXA 形式の. dat ファイル）につレ、ては、再生位置を指定でき 
ない。 

• 再生位置に関しては、指定された位置を超えない範囲で、最も近い位置が再生開始位置にな 
ります。 

①プログラム.ストリーム/ビデオ.エレメンタリ.ストリーム•ファイルの場合は、 MPEG ビデオ 
GOP の最初のピクチャ表示時刻が、指定された時刻を超えない範囲で、最も近いものをス 
キャンし、その位置を返す。 

感 オーディオ•エレメンタリ•ストリーム•ファイルの場合は、指定された時刻を超えない範囲で、 
最も近いオーディオ•アク七ス.ユニット（フレーム）の先頭位置を返す。 
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DECGetSyncStcValue 


HD814210 の SYNC STC レジスタの値を取得します。 

I 書す I 

DEC RETURN DEC Get Sync Stc Va 山 e(UINT dec id, LPDWORD pdwVa 山 e); 


1引数1 

decid 

pdwValue 

デコーダの識別子 

HD814210 の SYNC STC レジスタの値を取得する変数へのポインタ 

戻り値 
成功 
失敗 

DEC-SUCCESS 

DEC FAIL 


I 捕足 I 

• デコーダ . コア . レジスタからの読み込み時の （デコーダ • コア . アクセス.レジスタを用いた）ハン 
ドリングは MvrAvc.dll 内部で実行されるので、呼出側は、他のレジスタと同様に、単にデコー 
ダ • コア . レジスタを指定するだけで良い。 

•この API は通信サンプルプログラムでのみ使用して V 、ます。 

参 MVR - D 220 0 V では使用できません。 
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DEC_Get IRE Setting 


NTSC セットアップレベル(黒レベル）の設定を取得します。 


I 書す I 

DEC RETURN DEC Get IRE 夕 etting(UINT dec id , LPINT IpnIreSetting ); 


引数 


decjd デコーダの 識別子 

IpnIreSetting セットアップレベルの情報を格納するための INT 変数へのポインタ 


値 

説明 

MVR IRE LEVEL 0 NTSC 

OIRE 

MVR IRE LEVEL 75 NTSC 

7.5 IRE 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 
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DEC_Set IRE Setting 


NTSC セットアップレベル(黒レベル）を設定します。 


I 書ぶ I 

DEC RETURN DEC Set IRE SettingfUINT dec id , INT nIreSetting ); 


引数 


decjd デコーダの 識別子 

nlreSetting 設定する七ットアップレベル 


値 

説明 

MVR IRE LEVEL 0 NTSC 

OIRE 

MVR IRE LEVEL 75 NTSC 

7.5 IRE 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 


捕足 

• 日本では 0 IRE が標準です。 
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DECGetOverlayParameterEx 


オーバーレイの設定を取得します。 


I 書す I 

DEC_RETURN DEC_Get Overlay Parameter Ex(UINT decjd, 

DECPARAM OVERLAY fProp, LPDWORD IpdwValue); 


I 引数 I 

decjd デコーダの 識別子 

fProp 情報を取得する刘•象を指定します。な下の値のいずれかを指定します。 


値 

意お 

DECPARAM OVERLAY BRIGHTNESS 

明るさの値を取得します。 

DECPARAM OVERLAY HUE 

色合!/、の値を取得します。 

DECPARAM OVERLAY CONTRAST 

コントラストの 値を取得します。 

DECPARAM OVERLAY SATURATION 

色の濃さの値を取得します。 

DECPARAM OVERLAY FLIP 

フリッピングの設定状態を取得します。 

DECPARAM OVERLAY BOB 

BOB の設定状態を取得します。 


IpdwValue 取得した値を格納するための DWORD 変数へのポインタ 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 


I 補足 I 

• MVR - D 2200 V な外では使用できません。 


参照 

DEC Set Overlay-Parameter Ex、DEC Get Overlay Parameter Range Ex 
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DECSetOverlayParameterEx 


オーバーレイの設定を行なレ、ます。 


I 書す I 

DEC_Set Overlay Parameter Ex(UINT decjd, DECPARAM OVERLAY fProp, 

DWORD dwValue); 


I 引数 I 

decjd デコーダの 識別子 

fProp 情報を設定する対象を指定します。な下の値のいずれかを指定します。 


値 

意お 

DECPARAM OVERLAY BRIGHTNESS 

明るさの値を取得します。 

DECPARAM OVERLAY HUE 

色合!/、の値を取得します。 

DECPARAM OVERLAY CONTRAST 

コントラストの 値を取得します。 

DECPARAM OVERLAY SATURATION 

色の濃さの値を取得します。 

DECPARAM OVERLAY FLIP 

フリッピングの設定状態を取得します。 

DECPARAM OVERLAY BOB 

BOB の設定状態を取得します。 


dw Value 設をする値 


戻り値 

成功 DEC_SUCCESS 

失敗 DECFAIL 


精足 I 

• MVR - D 220 0 V な外では使用できません。 

#設定できる範囲等の情報は DEC Get Overlay Parameter Range Ex で取得します。 


参照 

DEC_Ge し Overlay_Parameter_Ex 、 DEC_Get_Overlay_Parameter_Range_Ex 
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DEC_Get_Overlay_Parameter_Range_Ex 


オーバーレイ表示パラメータの範囲を取得します。 


書式 


DEC-RETURN DEC_Get_Overlay_Parameter_Range_Ex( HINT dec id ， 

DECPARAM OVERLAY fProp, LPDECPARAM OVERLAY RANGE IpstRange); 


引数 


enc id エンコーダの識別子 

fProp 情報を取得する対象を指定します。な下の値のいずれかを指定します。 


値 

意み 

DECPARAM OVERLAY BRIGHTNESS 

明るさの値を取得します。 

DECPARAM OVERLAY HUE 

色合 V 、の値を取得します。 

DECPARAM OVERLAY CONTRAST 

コントラストの値を取得します。 

DECPARAM OVERLAY SATURATION 

色の濃さの値を取得します。 

DECPARAM OVERLAY FLIP 

フリッピングの設定状態を取得します。 

DECPARAM OVERLAY BOB 

BOB の設定状態を取得します。 


IpstRange 情報を取得する DECPARAM OVERLAY RANGE 構造体へのポインタ 


DECPARAM OVERLAY RANGE 構造体の定義 

オーバーレイ 表示 パラメータの 範囲の情報が格納される。 

typedef struct { 


BOOL 

fEnable; 

DWORD 

dwMin; 

DWORD 

dwMax; 

DWORD 

dwDef; 


} DECPARAM OVERLAY RANGE, *LPDECPARAM OVERLAY RANGE; 


fEnable 使用可能の情報が格納される。 

dwMin 範团の最小の値が格納される。 

dwMax 範囲の最大の値が格納される。 

dwDef デフオルトの値が格納される。 


戻り値 

成功 ENC_SUCCESS 

失敗 ENC FAIL 
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I 補足 I 

• MV 民 - D 220 OV が外では使用できません。 


参照 

DEC_Get IRE Setting 、 DEC_Set IRE Setting 
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DEC Get Last Error 


最新のエラー情報を取得します。 

ULONG DEC_Get Last Error(UINT decjd); 


1引数1 

decid 

デコーダの 識別子 

戻り値 

ULONG 

エラーコード (APPENDIX1. エラーコード表参照） 

補足 



DEC_Ge し Las し Error を実行すると、エラー情報はクリアされます。エラーが発生していない 
場合や新たにエラーが発生するまでは、 MVR ERROR SUCCESS が返されます。 
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MvrapLdll 使用時のエラーコードは次の通りです。 


MVR ERROR SUCCESS 

正常に終了。 

MVR_ERROR PENDING 

指定された操作はまだ完了していない。 

MVR ERROR SYSTEM ERROR 

システムに閱するエラーが発生した。 

MVR_ERROR NOT PENDING 

指定された操作は完了している。 

MVR_ERROR INVALID ASYNCOP 

イベントハンドルが無効。 

MVR_ERROR UNSUPPORTED 

サポートされていなレヴァンクションを実行した。 

MVR_ERROR INVALID TYPE 

セッションの種類が無効。 

MVR ERROR INVALID OPTION 

セッションのオプションが無劾。 

MVR ERROR INVALID ADDRESS 

アドレスが無効。 

MVR_ERROR LIMIT EXCEEDED 

制限値を越えている。 

MVR_ERROR INVALID HANDLE 

ハンドルが無効。 

MVR ERROR INVALID STREAM 

ストリームが無効。 

MVR ERROR INVALID BUFFER 

バッファが無効。 

MVR_ERROR INVALID MESSAGE 
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メッ七ージが 無効。 


MVR_ERROR CANCELED 

指定された要ホは取り消された。 

MVR_ERROR BUSY 

指定されたイベントハンドルは現在使用されている。 

MVR ERROR BUFFER ERROR 

バッファの初期化に失敗した。 

MVR ERROR MESSAGE ERROR 

メッ七ージに関するエラーが発生した。 

MVR_ERROR BAD PARAM 

無効なパラメータを指をした。 

MVR ERROR HARDWARE ERROR 

ハードウェアに関するエラーが発生した。 

MVR ERROR ALLOC-FAILURE 

リソースの割り当てに失放した。 

MVR ERROR INVALID EVENT 

イベントが無効。 

MVR_ERROR INVALID STATE 

ステータスが無効。 

MVR_ERROR CURRENT STATE 

ストリームが既に指定された状態にある。 

MVR ERROR INVALID FRAME TYPE 

フレームの種類が無効。 

MVR ERROR INSUFFICIENT BUFFERS 

バッファサイズが不十分。 

MVR_ERROR TIMEOUT 

タイムアウトが発生した。 

MVR_ERROR INVALID CODEC-STATE 

コーデックの状態が無劾。 

MVR ERROR INVALID FORMAT 

ストリームの形式が無効。 

MVR ERROR INVALID OPERATION 


指をされた操作は無訊 
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MVR ERROR OVERFLOW 

オーバーフローが発生した。 

MVR ERROR UNDERFLOW 

アンダーフローが発生した。 

MVR_ERROR SESSION_CANCELED 

セッションが取り消された。 

MVR_ERROR UCODE NOT FOUND 

マイクロコードが見つからない。 

MVR_ERROR AUDIO UCODE NOT FOUND 

オーディオのマイクロコードが見つからない。 

MVR ERROR PARSE ERROR 

ビットストリーム形式が無効。 

MVR_ERROR END OF STREAM 

シーク操作中にビ外ストリームの最後に達した。 

MVR_ERROR DISK FULL 

ディスクがいっぱいになった。 

MVR ERROR STREAMS-CLOSED 

ストリームは破棄されている。 

MVR ERROR INTERNAL ERROR 

内部エラーが発生し t 

MVR_ERROR INVALID SHORT BUFFER 

バッファは完全に満たされていない。 

MVR_ERROR NO_VIDEO SOURCE 

ビデオ信号が入力されていない。 

MVR_ERROR DEVICE NOT FOUND 

デバイスが見つろみない。 

MVR ERROR EVENT DATA OVERRUN 


MPEG ビデオ.データまたはオーディオ PCM データの、デバイスからの収集(吸い上げ)が間に合 
わない。 

(原因） 

1. PC の処理性能が低い。 

2. 録画中に、他のアプリケーションを起動/動作させたため、データの吸い上げが一時的に間に 
合わなくなった。 

3. 正しいビデオ信号が入力されていない。 
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ドライバ内部のマルチプレクサ•プログラムは、データ吸い上げのため一定個数のバッファを割り当 
て、そのバッファを MPEG ビデオ•データまたはオーディオ PCM データの吸い上げに使い回します。 
入力されているビデオ信号の周期が乱れたり、フィールドが欠落したりすると、それに応じて、 
MPEG ビデオ•エンコーダから出力されるデータの転送周巧が不正確となり、ビデオ•データに対し 
てマルチプレクサが割り当てているバッファが足らなくなったり、あるいは、逆に、オーディオ•デー 
夕にバッファを割り当てられなくなったりします。 

具体的には、下記の様な状況で発生します。 

( a ) 劣化したビデオ•テープを入カソースとして使用すると、ビデオ信号が正しい周期 ( NTSC ならば、 
29.97 Hz ) で入力されていなレ、場合があります。 

似ビデオ•テープに複数の映像ソースが重ね書きされている t 映像ソースの変わり目で、不正な 
ビデオ信号が発生します。 


似入力映像が途中で途切れると、不正なビデオ信号が発生する場合があります。 


MVR_ERROR EVENT DATA UNDERRUN 

アンダーランが発生した。 

MVR_ERROR EVENT DEVICE ERROR 

デバイスエラーが発生した。 

MVR_ERROR EVENT LOSS_OF VIDEO 

データの引き抜きは間に合っているが、弓1き抜かれたデータが不正、またはデータの一部が欠落 

した。 

MVR_ERROR EVENT EVENT LOSS 

イベントエラーが発生した。 

MVR_ERROR EVENT UNRECOVERABLE ERROR 

回復不可能なエラーが発生した。 

システムを一度終了してから、再起動させてください。 

MVR ERROR EVENT WARNING 

警告エラーが発生し t 

MVR_ERROR EVENT VIDEO ENCODER VBV_UNDERFLOW 

ビット.レート.コントロールに失敗した。 

ビ外レートをあげるろ\ビデオ入カフォーマ外を SIF または Half - Dl に設定してください。 

MVR_ERROR EVENT VIDEO ENCODER OVERRUN-STATE 


データの 引き抜きが間に合わなかった等の原因で、ビデオ入力の数フレームが エンコード できなか 
った。 

原因となるのは、 


(a) 録画中に他のアプリを起動した。あるいは、他のアプリで重い処理を実行した。 
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( b ) 他の l /0( 特に、 P 幻バスを使用する I / O ) に時間が力かっている。 
( C ) ドライバ関連のモジュールがスワップ•アウトされている。 

( d ) マシンの性能がほい。 
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カノー プス株式会社 

本社/ t6 日 1-2241 神尸市西区室お 1-2-2 ( 神尸ハイテクパーク巧） 

参 MV 民 Series Development Kit の 

技術的なお問い合わせはくカノープスシステム開発サポーいへ 
インターホットじ - mail : mvrsdk @ canopus . co.Jp 

FAX ： 078-992-4203 

^FAX でお問い合わせの際は、 FAX 番号をよくお確かめください。 

☆最新の情報をホームページでご覧になれます。 

http :// www . canopus . co . ip / 
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